1. Gemini API 키 발급받기
- Google AI Studio 접속: Google AI Studio (aistudio.google.com)에 구글 로그인
- API 키 생성: Get API key를 클릭
- 프로젝트 선택: Create API key 버튼을 누르고, 기존 Google Cloud 프로젝트를 선택 또는 새 프로젝트를 생성하여 키 발급
- 환경변수 등록: 발급받은 키(알파벳과 숫자가 섞인 긴 문자열)를 복사하여 프로젝트 루트의 .env 파일에 저장합니다.
# .env 파일
GEMINI_API_KEY="...발급받은_키_입력..."2. 발생했던 에러 (404 Not Found)
API 키를 넣고 무작정 인터넷에 있는 예제 코드(gemini-1.5-flash 등)를 복사해서 호출시 아래와 같은 에러가 발생
Error 404: models/gemini-1.5-flash is not found for API version v1beta, or is not supported for generateContent. Call ListModels to see the list of available models and their supported methods.
원인 : 구글 API 버전이 업데이트되거나 계정 권한에 따라 접근 가능한 모델의 정확한 이름(버전)이 다르기 때문입니다.
해결 : 에러 메시지의 조언대로 ListModels를 호출해서 내가 쓸 수 있는 정확한 모델명을 먼저 확인해야 한다.
3. 사용 가능한 모델 목록 확인하는 Go 코드
Go 언어용 공식 SDK(github.com/google/generative-ai-go/genai)를 설치 후, 아래 코드를 실행하면 현재 API 키로 사용할 수 있는 모든 모델의 리스트가 출력된다.
라이브러리 설치
go get github.com/google/generative-ai-go/genai
go get google.golang.org/api/option
모델 확인용 코드 (예시는 main.go에서 작성)
package main
import (
"context"
"fmt"
"log"
"os"
"github.com/google/generative-ai-go/genai"
"google.golang.org/api/iterator"
"google.golang.org/api/option"
)
func main() {
ctx := context.Background()
// 환경변수에서 API 키 불러오기
apiKey := os.Getenv("GEMINI_API_KEY")
if apiKey == "" {
log.Fatal("GEMINI_API_KEY가 설정되지 않았습니다.")
}
// Gemini 클라이언트 생성
client, err := genai.NewClient(ctx, option.WithAPIKey(apiKey))
if err != nil {
log.Fatal(err)
}
defer client.Close()
fmt.Println("=== 사용 가능한 모델 목록 ===")
// ListModels를 호출하여 모델 이터레이터 가져오기
iter := client.ListModels(ctx)
for {
m, err := iter.Next()
if err == iterator.Done {
break
}
if err != nil {
log.Fatal(err)
}
// 모델의 정확한 이름 출력
fmt.Println(m.Name)
}
}4. 모델 확인 결과 및 적용
위 코드를 실행하면 콘솔에 아래와 같이 사용 가능한 모델들의 정확한 식별자가 출력된다.
go run main.go
// 아래는 출력내용
=== 사용 가능한 모델 목록 ===
models/gemini-1.0-pro
models/gemini-1.5-flash
models/gemini-2.5-flash <-- 최신/원하는 모델 확인!
models/embedding-001
...출력된 리스트에서 원하는 모델의 이름(예: gemini-2.5-flash)을 확인했다면, 이제 실제 비즈니스 로직 코드에서 해당 문자열을 그대로 사용하면 404 에러 없이 깔끔하게 통신이 성공한다!
// 실제 서비스 코드 적용 예시
model := client.GenerativeModel("gemini-2.5-flash")
※Google AI Studio (API) 무료 플랜 핵심 제한(2026.05.10 기준)
- RPD (일일 요청 수): 하루 최대 250회
- RPM (분당 요청 수): 분당 최대 10회
- TPM (분당 토큰 수): 분당 최대 250,000 토큰
개인개발용으로는 충분하다고 생각한다(무료인것에 감사)
