오류

API가 반환하는 모든 오류 코드, 의미, 다음 조치.

오류 형식

오류 본문 형식: { "code": "…", "error": "…" }. 메시지가 아닌 code로 분기하세요. 결과가 확실할 때만 재시도하고, 네트워크 결과가 불확실하면 Idempotency-Key를 유지하세요. 응답에는 지원 문의 시 알려 줄 x-request-id 헤더가 포함됩니다.

오류 코드

HTTP	코드	의미 및 조치
`401`	`AUTH_REQUIRED`	API 키 또는 세션이 없거나 유효하지 않습니다.
`403`	`INSUFFICIENT_SCOPE`	API 키에 이 엔드포인트에 필요한 권한이 없습니다.
`403`	`PERMISSION_DENIED`	이 자격 증명으로는 이 작업을 수행할 수 없습니다.
`429`	`API_KEY_RATE_LIMITED`	API 키의 요청 한도에 도달했습니다. Retry-After를 따르세요.
`429`	`API_KEY_USAGE_EXCEEDED`	API 키가 사용 한도에 도달했습니다. 새 키를 생성하세요.
`400`	`INVALID_REQUEST`	본문이 JSON 객체가 아니거나 필수 값이 없습니다.
`400`	`INVALID_IDEMPOTENCY_KEY`	Idempotency-Key는 1~128자의 출력 가능한 ASCII 문자여야 합니다.
`400`	`INVALID_MODEL_INPUT`	input이 모델 스키마와 일치하지 않습니다(알 수 없는 필드, 누락된 필수 필드 또는 잘못된 값).
`400 / 413`	`INPUT_TOO_LARGE`	요청 본문이 256KB를 초과합니다. 미디어를 먼저 업로드하고 미디어 참조를 보내세요.
`404`	`REQUEST_NOT_FOUND`	No chat request with this ID belongs to your account.
`404`	`MODEL_NOT_FOUND`	이 slug를 가진 모델이 없습니다.
`404`	`JOB_NOT_FOUND`	이 ID의 작업은 계정에 속하지 않습니다.
`409`	`IDEMPOTENCY_CONFLICT`	이 Idempotency-Key는 다른 입력으로 사용되었습니다. 새 요청에는 새 키를 사용하세요.
`409`	`PRICE_CHANGED`	가격이 expectedPriceMicros와 다릅니다. 가격을 다시 가져와 확인하세요.
`409`	`MODEL_PRICE_UNAVAILABLE`	이 모델에는 아직 가격이 설정되지 않아 실행할 수 없습니다.
`409`	`PAYMENT_REVIEW_REQUIRED`	A refund left an uncovered balance. Contact support or cover the balance before submitting tasks.
`409`	`INSUFFICIENT_CREDITS`	사용 가능한 크레딧이 작업 가격보다 부족합니다.
`429`	`RATE_LIMITED`	분당 작업 제출이 너무 많습니다. 나중에 다시 시도하세요.
`429`	`CONCURRENCY_LIMITED`	완료되지 않은 작업이 너무 많습니다. 하나가 끝날 때까지 기다리세요.
`503`	`EXECUTION_UNAVAILABLE`	현재 이 모델의 실행이 구성되어 있지 않습니다.
`429`	`UPSTREAM_RATE_LIMITED`	The model provider is rate limiting chat requests. Retry with backoff; nothing was charged.
`502`	`UPSTREAM_ERROR`	The model provider failed the chat request. Nothing was charged; retry later.
`503`	`PLATFORM_BUDGET_EXCEEDED`	This model is temporarily unavailable. Try again later.
`503`	`EXECUTION_TEMPORARILY_UNAVAILABLE`	실행을 일시적으로 사용할 수 없습니다. 같은 Idempotency-Key로 다시 시도하세요.
`503`	`AUTH_UNAVAILABLE`	인증을 일시적으로 사용할 수 없습니다. 나중에 다시 시도하세요.
`503`	`API_UNAVAILABLE`	API를 일시적으로 사용할 수 없습니다. 나중에 다시 시도하세요.