화면 모드
오류 코드
모든 오류는 아래 형식으로 옵니다. 프로그램에서는 HTTP 상태와 error.code로 분기하세요.
json
{ "error": { "message": "…", "type": "…", "code": "…" } }공통
| HTTP | code | 뜻 | 대응 |
|---|---|---|---|
| 400 | invalid_request | 파라미터 형식이나 값이 잘못됨 | message를 보고 값을 고쳐 다시 요청 |
| 401 | — | API 키가 없거나, 틀렸거나, 삭제·만료됨 | 헤더 형식과 키 상태 확인 → 401 |
| 402 | insufficient_user_quota | 계정 잔액 부족 | 충전 후 다시 요청 → 402 |
| 503 | model_not_available | 요청한 모델을 지금 쓸 수 없음 | 모델 이름 확인, 잠시 후 다시 시도 |
402 오류의 type은 insufficient_quota입니다.
이미지
code | 뜻 | 대응 |
|---|---|---|
result_timeout | 접수는 됐지만 대기 시간 안에 결과가 오지 않음 | 잠시 후 다시 시도 → 문제 해결 |
영상
| HTTP | code | 뜻 |
|---|---|---|
| 400 | invalid_request | seconds가 4–15 정수가 아님, resolution이 480p·720p가 아님, prompt 누락 |
| 404 | video_not_found | 작업 ID가 없거나 내 작업이 아님 |
| 409 | video_not_ready | /content 호출 시 아직 완료 전 |
생성 중 실패한 작업은 GET /v1/videos/{id} 응답에서 status: "failed"와 함께 error.code로 이유를 알려 줍니다.
error.code | 뜻 |
|---|---|
video_generation_failed | 생성 실패. 금액은 자동 환불 |
video_generation_timeout | 접수 후 3시간 안에 끝나지 않아 실패 처리. 금액은 자동 환불 |