오류
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는 비어 있지 않은 배열이어야 합니다 | Returned when `input_keys` is missing or empty. |
| 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 | Returned when `video_category` is not supported. |
| 400 | invalid_request_error | 유효하지 않은 aspect_ratio입니다. 허용 값: square, portrait, landscape | Returned when `aspect_ratio` is not supported. |
| 400 | invalid_request_error | output_length는 양의 숫자여야 합니다 | Returned when `output_length` is missing, zero, or negative. |
| 400 | invalid_request_error | input_keys 메타데이터에서 양수 입력 길이를 결정할 수 없습니다 | API가 업로드된 입력의 유효한 길이를 결정할 수 없는 경우 반환됩니다. |
| 400 | invalid_request_error | music_volume은 0에서 100 사이의 숫자여야 합니다 | Returned when `music_volume` is provided but is not a valid number between 0 and 100. |
| 400 | invalid_request_error | original_audio_volume은 0에서 100 사이의 숫자여야 합니다 | Returned when `original_audio_volume` is provided but is not a valid number between 0 and 100. |
| 400 | invalid_request_error | 유효하지 않은 music_category입니다. 허용 값: corporate, romantic, sports, kids_and_comedy, ambient_and_nature, horror_and_suspense, documentary, trending_vlogs | Returned when `music_category` is provided but does not match one of the supported music categories. |
| 401 | authentication_error | API 키가 없습니다 | Returned when the `x-api-key` header is not provided. |
| 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 주소로 대체 적용됩니다. 이 한도에 도달한 클라이언트는 요청 빈도를 줄이고 속도 제한 창이 재설정된 후 다시 시도해야 합니다. |
| 429 | rate_limit_error | 현재 실행 중이거나 대기 중인 작업이 이미 10개로, 허용된 최대입니다. 다른 작업을 제출하기 전에 일부 작업이 완료될 때까지 기다려 주세요. | 사용자가 서버에서 실행 중인 작업과 대기열의 보류 중인 작업을 합쳐 이미 허용된 최대 진행 중 작업 수를 보유한 경우 반환됩니다. 현재 한도는 사용자당 총 10개의 실행 중 또는 대기 중 작업입니다. 소유권은 바쁜 서버의 각 job_id 및 대기열 항목을 해당 작업의 user_email과 대조하여 결정됩니다. 이 한도에 도달한 클라이언트는 새 작업을 생성하거나 렌더링하기 전에 하나 이상의 기존 작업이 완료될 때까지 기다려야 합니다. |
| 500 | api_error | 인증 오류 | 서버에서 API 키 인증이 예상치 못하게 실패한 경우 반환됩니다. |
| 500 | api_error | 내부 서버 오류 | 상태, 렌더 또는 하이라이트 릴 엔드포인트에서 예기치 않은 서버 측 오류가 발생한 경우 반환됩니다. |
| 500 | server_error | 업로드 URL 생성 실패 | 서버가 서명된 업로드 URL을 생성하지 못한 경우 반환됩니다. |