오류

실패한 요청은 error 객체와 함께 JSON을 반환합니다. HTTP 상태는 첫 번째 신호입니다. message 및 code 필드는 실제 실패를 나타냅니다.

JSON

{
  "error": {
    "message": "Invalid API key provided.",
    "type": "authentication_error",
    "code": "invalid_api_key"
  }
}

공통 상태 코드

상태	일반적인 원인
400	잘못된 JSON, 지원되지 않는 필드 또는 모델의 잘못된 엔드포인트
401	API 키가 누락되었거나 유효하지 않습니다.
403	키는 이 모델 또는 그룹을 사용할 수 없습니다
404	알 수 없는 경로 또는 누락된 작업
429	비율 제한
499	클라이언트가 요청을 취소했습니다.
5xx	서비스 제공업체 또는 게이트웨이 오류

잘못된 프로토콜로 전송된 이미지 및 비디오 요청은 unsupported_endpoint과 함께 400을 반환하고 필요한 API의 이름을 지정합니다. 자동 프로토콜 변환은 텍스트 모델에만 적용됩니다.

더 긴 진단, 재시도 및 대체는 AI API 오류 문제 해결부터 시작하여 기본 사이트의 기술 문서에 속합니다.