오류 및 제한
모든 실패는 하나의 봉투를 사용합니다. 코드는 안정적이며, 메시지는 사용자에게 표시할 수 있는 영어 폴백입니다.
{
"error": {
"code": "insufficient_credits",
"message": "You need more credits to generate."
}
}상태
| HTTP | 일반적인 코드 | 무엇을 해야 할까요 |
|---|---|---|
| 400 | invalid_request, prompt_too_long, invalid_reference_image | 요청을 수정하세요; 변경 없이 재시도하지 마세요 |
| 401 | unauthorized | 키를 확인하세요. 루프에서 재시도하지 마세요 |
| 402 | insufficient_credits | 크레딧을 충전하세요. 절대 재시도하지 마세요 |
| 403 | unauthorized | 미결제 키 생성 또는 프리미엄 없이 요청된 오디오 |
| 404 | not_found | 알 수 없는 작업이거나 이 계정의 작업이 아닙니다 |
| 409 | invalid_request | Idempotency-Key 충돌이 발생했습니다. 새 키를 사용하세요. |
| 413 / 415 | invalid_request / unsupported_image_type | 더 작은 JPEG, PNG 또는 WebP를 업로드하세요 |
| 429 | rate_limited | Retry-After를 기다리세요 |
| 500 / 503 | internal | 백오프로 재시도 |
400
- 일반적인 코드
invalid_request,prompt_too_long,invalid_reference_image- 무엇을 해야 할까요
- 요청을 수정하세요; 변경 없이 재시도하지 마세요
401
- 일반적인 코드
unauthorized- 무엇을 해야 할까요
- 키를 확인하세요. 루프에서 재시도하지 마세요
402
- 일반적인 코드
insufficient_credits- 무엇을 해야 할까요
- 크레딧을 충전하세요. 절대 재시도하지 마세요
403
- 일반적인 코드
unauthorized- 무엇을 해야 할까요
- 미결제 키 생성 또는 프리미엄 없이 요청된 오디오
404
- 일반적인 코드
not_found- 무엇을 해야 할까요
- 알 수 없는 작업이거나 이 계정의 작업이 아닙니다
409
- 일반적인 코드
invalid_request- 무엇을 해야 할까요
Idempotency-Key충돌이 발생했습니다. 새 키를 사용하세요.
413 / 415
- 일반적인 코드
invalid_request/unsupported_image_type- 무엇을 해야 할까요
- 더 작은 JPEG, PNG 또는 WebP를 업로드하세요
429
- 일반적인 코드
rate_limited- 무엇을 해야 할까요
Retry-After를 기다리세요
500 / 503
- 일반적인 코드
internal- 무엇을 해야 할까요
- 백오프로 재시도
실패한 생성은 status: "failed"와 코드 internal의 error 객체를 포함한 200 작업 응답입니다. 완료된 작업은 종료 상태이므로 다시 제출하지 마세요.
재시도 정책
- HTTP
429,timeout및internal응답만 재시도하세요. insufficient_credits는 절대 재시도하지 말고, 이미failed로 종료된 작업은 절대 다시 제출하지 마세요.- 생성 시
Idempotency-Key를 사용하여 재시도로 인해 두 번 청구되지 않도록 하세요. - 약 1초부터 시작하여 지터를 더해 지수적으로 백오프하세요.
속도 제한
한도는 별도 표기가 없는 한 고정 1분 단위 시간 창에서 키별로 적용됩니다. 기본값:
- 60 요청/분 전체.
- 분당 10회 생성.
- 분당 5회 업로드.
- 클라이언트 IP당 분당
GET /v1/models요청 120회(해당 경로는 공개됨). - 계정당 시간당 API 키 생성 5회.
429에는 X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset 및 Retry-After가 포함됩니다.
가용성
/v1을 일시적으로 사용할 수 없으면 모든 경로가 코드 internal과 함께 503으로 응답합니다. 잠시 후 백오프하며 다시 시도하세요.