이 가이드를 사용하여 Gemini API를 호출합니다 API 키 문제가 발생하면 API 키 설정 가이드에 따라 API 키를 올바르게 설정해야 합니다.
오류 코드
다음 표에는 발생할 수 있는 일반적인 오류 코드와 원인 설명 및 문제 해결 단계:
| HTTP 코드 | 상태 | 설명 | 해결 방법 |
| 400 | INVALID_ARGUMENT | 요청 본문 형식이 잘못되었습니다. | 요청 형식, 예시, 지원되는 버전은 API 참조를 확인하세요. 최신 API 버전의 기능을 이전 엔드포인트와 함께 사용하면 오류가 발생할 수 있습니다. |
| 400 | FAILED_PRECONDITION | 거주 중인 국가에서는 Gemini API 무료 등급을 사용할 수 없습니다. Google AI Studio에서 프로젝트에 결제를 사용 설정하세요. | Gemini API를 사용하려면 Google AI Studio를 사용하여 유료 요금제를 설정해야 합니다. |
| 403 | PERMISSION_DENIED | API 키에 필요한 권한이 없습니다. | API 키가 설정되어 있고 올바른 액세스 권한이 있는지 확인하세요. |
| 404 | NOT_FOUND | 요청한 리소스를 찾을 수 없습니다. | API 버전에 대해 요청의 모든 매개변수가 유효한지 확인합니다. |
| 429 | RESOURCE_EXHAUSTED | 비율 제한을 초과했습니다. | 모델의 비율 제한 내에 있는지 확인합니다. 필요한 경우 할당량 증가를 요청합니다. |
| 500 | 내부 | Google 측에서 예기치 않은 오류가 발생했습니다. | 잠시 기다린 후 요청을 다시 시도하세요. 다시 시도해도 문제가 지속되면 Google AI Studio의 의견 보내기 버튼을 사용하여 신고해 주세요. |
| 503 | 현재 구매할 수 없음 | 서비스가 일시적으로 과부하되거나 다운될 수 있습니다. | 잠시 기다린 후 요청을 다시 시도하세요. 다시 시도해도 문제가 지속되면 Google AI Studio의 의견 보내기 버튼을 사용하여 신고해 주세요. |
API 호출에서 모델 매개변수 오류 확인
모델 매개변수가 다음 값 내에 있는지 확인합니다.
| 모델 매개변수 | 값 (범위) |
| 후보자 수 | 1~8 (정수) |
| 온도 | 0.0~1.0 |
| 최대 출력 토큰 |
사용
get_model (Python)
를 사용하여 사용 중인 모델의 최대 토큰 수를 결정합니다.
|
| TopP | 0.0~1.0 |
매개변수 값을 확인하는 것 외에도 올바른
API 버전 (예: /v1 또는 /v1beta) 및
지원하는 모델을 빌드해야 합니다 예를 들어 기능이 베타 버전인 경우
/v1beta API 버전에서만 사용할 수 있습니다.
올바른 모델이 있는지 확인
다음에 나열된 지원되는 모델을 사용하고 있는지 확인하세요. 모델 페이지를 참조하세요.
안전 문제
API 호출의 안전 설정으로 인해 프롬프트가 차단된 경우 API 호출에서 설정한 필터와 관련하여 프롬프트를 검토합니다.
BlockedReason.OTHER이(가) 표시되면 쿼리 또는 응답이 약관을 위반한 것일 수 있습니다.
서비스 또는 기타 지원되지 않을 수 있습니다.
모델 출력 개선
모델 출력을 개선하려면 더 정형화된 프롬프트를 작성해 보세요. 이 프롬프트 설계 소개 페이지에서는 시작하는 데 도움이 되는 몇 가지 기본 개념, 전략 및 권장사항을 확인하세요.
좋은 입출력 쌍의 예시가 수백 개 있는 경우 모델 조정을 고려하세요.
토큰 한도 이해하기
토큰 가이드에서 방법을 자세히 알아보세요. 토큰과 토큰의 한도를 계산할 수 있습니다.
알려진 문제
- API는 영어만 지원합니다. 프롬프트를 여러 언어로 제출하면 예기치 않거나 심지어 차단된 응답을 생성합니다. 사용 가능한 언어를 참조하세요.
버그 신고
Google AI 개발자 포럼에서 토론에 참여하세요. 에 문의하세요.