오류
실패는 표준 HTTP 상태 코드와 일관된 응답 형식(envelope)을 사용합니다.
오류 응답
{ "success": false, "error": { "code": 1001, "message": "Missing API key.", "httpStatus": 401 } }상태 코드
| 상태 | 의미 |
|---|---|
400 | 검증 — 잘못되거나 누락된 파라미터, 지원되지 않는 모델 또는 이미지. |
401 | 누락 / 유효하지 않음 / 해지된 키 (code 1001). |
403 | 계정에 API 사용 권한이 없거나 크레딧이 부족합니다. |
404 | 자산 / 컬렉션을 찾을 수 없거나 본인 소유가 아닙니다. |
429 | 요청 제한 초과 (code 10003). |