오류
VIDIO API는 일관된 오류 객체 형식을 사용합니다. 이 페이지를 사용하여 일반적인 오류 유형, HTTP 상태 코드 및 API에서 반환되는 예제 메시지를 이해하십시오.
현재 스튜디오 플랜 및 그 이상에 대한 API 액세스가 가능합니다.
개요
요청이 실패하면 VIDIO API는 error 객체를 반환하며, 여기에 type과 message가 포함됩니다. 일부 오류는 실패를 설명하는 데 도움이 되는 추가 필드를 포함할 수 있습니다.
오류 형식
json
{
"error": {
"type": "invalid_request_error",
"message": "작업을 찾을 수 없음"
}
}오류 참조
| Status | Type | Message | Description |
|---|---|---|---|
| 400 | invalid_request_error | 업로드 URL 요청에 필수 쿼리 매개변수가 누락되었습니다 | 업로드 URL 요청에 필수 쿼리 매개변수가 없을 때 반환됩니다. |
| 400 | invalid_request_error | job_id가 누락되었습니다 | 렌더 요청에 job ID가 포함되어 있지 않을 때 반환됩니다. |
| 400 | invalid_request_error | 이 작업에 사용 가능한 출력이 없습니다 | 작업에 렌더링 가능한 출력이 없을 때 반환됩니다. |
| 400 | invalid_request_error | input_keys는 비어 있지 않은 배열이어야 합니다 | `input_keys`가 없거나 비어 있을 때 반환됩니다. |
| 400 | invalid_request_error | input_keys에는 적어도 하나의 유효한 입력 키가 포함되어야 합니다 | 제공된 모든 입력 키가 정규화 후 빈 값이거나 유효하지 않을 때 반환됩니다. |
| 400 | input_duration_requirement_error | 총 입력 길이는 2초보다 길어야 합니다 | 모든 입력 미디어의 총합 길이가 2초 이하일 때 반환됩니다. |
| 400 | input_duration_requirement_error | 총 입력 길이는 6시간 미만이어야 합니다 | 모든 입력 미디어의 총합 길이가 6시간 이상일 때 반환됩니다. |
| 400 | input_image_count_requirement_error | 입력 이미지 수는 4000장을 초과할 수 없습니다 | 입력 이미지 수가 최대 허용 한도인 4000을 초과할 때 반환됩니다. |
| 400 | input_video_count_requirement_error | 입력 비디오 수는 400개를 초과할 수 없습니다 | 입력 비디오 수가 최대 허용 한도인 400을 초과할 때 반환됩니다. |
| 400 | invalid_request_error | video_category가 유효하지 않습니다. 허용되는 값: podcast, ball-sports, non-ball-sports, beauty-product-demo, wedding, travel, others | `video_category`가 지원되지 않을 때 반환됩니다. |
| 400 | invalid_request_error | aspect_ratio가 유효하지 않습니다. 허용되는 값: square, portrait, landscape | `aspect_ratio`가 지원되지 않을 때 반환됩니다. |
| 400 | invalid_request_error | output_length는 양수여야 합니다 | `output_length`가 없거나 0이거나 음수일 때 반환됩니다. |
| 400 | invalid_request_error | input_keys 메타데이터에서 양의 입력 길이를 결정할 수 없습니다 | API가 업로드된 입력에 대한 유효한 길이를 결정할 수 없을 때 반환됩니다. |
| 401 | authentication_error | API 키가 없습니다 | `x-api-key` 헤더가 제공되지 않았을 때 반환됩니다. |
| 401 | authentication_error | API 키가 유효하지 않습니다 | 제공된 API 키가 활성 키와 일치하지 않을 때 반환됩니다. |
| 402 | insufficient_balance | 이 작업을 처리할 충분한 크레딧이 없습니다 | 계정에 처리 또는 렌더링을 위한 충분한 크레딧이 없을 때 반환됩니다. |
| 403 | permission_error | 이 작업에 접근할 권한이 없습니다 | 인증된 사용자가 요청한 작업을 소유하지 않을 때 반환됩니다. |
| 403 | permission_error | 이 작업을 렌더링할 권한이 없습니다 | 인증된 사용자가 렌더링 중인 작업을 소유하지 않을 때 반환됩니다. |
| 404 | invalid_request_error | 작업을 찾을 수 없습니다 | 요청한 작업이 존재하지 않을 때 반환됩니다. |
| 404 | invalid_request_error | 사용자를 찾을 수 없습니다 | 인증된 사용자 레코드를 찾을 수 없을 때 반환됩니다. |
| 429 | rate_limit_error | 요청이 너무 많습니다 | 엔드포인트에 대한 허용 요청 속도를 초과할 때 반환됩니다. 현재 제한은 분당 60회 요청입니다. 속도 제한은 주로 x-api-key 헤더를 사용하는 API 키별로 적용되며, API 키가 없을 경우 클라이언트 IP 주소로 대체됩니다. 이 제한에 걸린 클라이언트는 요청 빈도를 줄이고 속도 제한 창이 재설정된 후 재시도해야 합니다. |
| 500 | api_error | 인증 오류 | 서버에서 API 키 인증이 예기치 않게 실패할 때 반환됩니다. |
| 500 | api_error | 내부 서버 오류 | 상태, 렌더링 또는 하이라이트 릴 엔드포인트에서 예기치 않은 서버 측 실패가 발생할 때 반환됩니다. |
| 500 | server_error | 업로드 URL을 생성하지 못했습니다 | 서버가 서명된 업로드 URL을 생성하지 못할 때 반환됩니다. |