API 문서API 문서
오류
안정적인 오류 구조, 코드, HTTP 상태
오류는 고정된 봉투 구조로 반환되며 비공개 진단 정보를 담지 않습니다:
{
"success": false,
"error": {
"code": "INVALID_REQUEST",
"message": "The request is invalid.",
"request_id": "req_012345"
}
}| HTTP | 코드 | 의미 |
|---|---|---|
| 400 | INVALID_REQUEST | 본문, 폼 필드, 헤더 또는 이미지가 유효하지 않음 |
| 400 | CONTENT_POLICY_VIOLATION | 이 요청은 처리할 수 없음 |
| 401 | UNAUTHORIZED | API 키가 없거나 유효하지 않음 |
| 402 | INSUFFICIENT_CREDITS | 사용 가능한 잔액이 부족함 |
| 403 | FORBIDDEN | 필요한 범위 또는 베타 접근 권한이 없음 |
| 404 | JOB_NOT_FOUND | 작업이 없거나 다른 계정의 것임 |
| 409 | IDEMPOTENCY_CONFLICT | 같은 키가 다른 내용으로 재사용됨 |
| 409 | JOB_CANCELED | 작업이 취소됨 |
| 429 | RATE_LIMIT_EXCEEDED | 요청 한도를 초과함 |
| 500 | JOB_FAILED | 이미지 작업을 완료하지 못함 |
| 500 | INTERNAL_ERROR | 요청을 완료하지 못함 |
업로드 용량 초과는 HTTP 413과 INVALID_REQUEST로 반환됩니다. 429와 종료되지
않은 작업은 문서에 적힌 지연 시간을 두고 재시도 가능한 것으로 간주하세요. 그 밖의
오류는 요청을 고치거나 request_id와 함께 지원에 문의하시고, 사람이 읽는 메시지를
프로그램 로직의 판단 근거로 파싱하지 마세요.