Gemini API 400 (INVALID_ARGUMENT / FAILED_PRECONDITION · 잘못된 요청)
지금 장애가 있나요?
Gemini API / AI Studio 공식 상태는 정상입니다. 이 오류가 계속되면 구현(코드) 또는 사용자 환경 문제일 가능성이 높습니다.
Gemini API / AI Studio의 가동 상태 보기 →오류의 의미
400은 요청이 유효하지 않다는 의미입니다. 잘못된 파라미터, 형식이 잘못된 본문, 유효하지 않은 API 키, 또는 FAILED_PRECONDITION으로서 결제가 활성화되지 않았거나 해당 리전에서 무료 등급을 사용할 수 없는 경우입니다.
자주 있는 원인
- •유효하지 않거나 범위를 벗어난 파라미터(예: 지원되지 않는 generationConfig 값)
- •형식이 잘못된 요청 본문 또는 잘못된 필드명
- •유효하지 않은 API 키, 또는 다른 API 전용으로 제한된 키
- •FAILED_PRECONDITION: 결제 미활성화, 또는 해당 리전에서 무료 등급 사용 불가
- •지원되지 않는 파일 형식 / inline 데이터가 너무 큼
해결 방법
- 1.에러 상세를 확인하세요. 문제가 된 필드를 알려줍니다
- 2.요청 본문과 파라미터 범위를 검증하세요
- 3.API 키가 유효하고 Generative Language API를 호출할 수 있는지 확인하세요
- 4.결제를 활성화하거나 지원되는 리전을 사용하세요
- 5.파일의 MIME 타입과 크기 한도를 확인하세요
기다리면 되는 경우 / 기다려도 안 되는 경우
요청/설정 문제이므로 기다려도 해결되지 않습니다. 상세에 명시된 파라미터, 키, 결제/리전을 수정하세요.
Gemini API / AI Studio을(를) 쓸 수 없을 때의 대체
관련 오류
자주 묻는 질문
400 INVALID_ARGUMENT은(는) 무엇인가요?
400은 요청이 유효하지 않다는 의미입니다. 잘못된 파라미터, 형식이 잘못된 본문, 유효하지 않은 API 키, 또는 FAILED_PRECONDITION으로서 결제가 활성화되지 않았거나 해당 리전에서 무료 등급을 사용할 수 없는 경우입니다.
400 INVALID_ARGUMENT은(는) 어떻게 해결하나요?
에러 상세를 확인하세요. 문제가 된 필드를 알려줍니다 / 요청 본문과 파라미터 범위를 검증하세요 / API 키가 유효하고 Generative Language API를 호출할 수 있는지 확인하세요 / 결제를 활성화하거나 지원되는 리전을 사용하세요 / 파일의 MIME 타입과 크기 한도를 확인하세요