エラー

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が欠落しています	レンダリングリクエストにジョブIDが含まれていない場合に返されます。
400	invalid_request_error	このジョブには出力がありません	ジョブにレンダリング可能な出力がない場合に返されます。
400	invalid_request_error	input_keysは空でない配列でなければなりません	`input_keys`が不足しているか空の場合に返されます。
400	invalid_request_error	input_keysは少なくとも1つの有効な入力キーを含める必要があります	正規化後に提供されたすべての入力キーが空または無効な場合に返されます。
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がアップロードされた入力の有効な再生時間を判定できない場合に返されます。
400	invalid_request_error	music_volumeは0から100の間の数値でなければなりません	`music_volume`が指定されているが、0から100の間の有効な数値ではない場合に返されます。
400	invalid_request_error	original_audio_volumeは0から100の間の数値でなければなりません	`original_audio_volume`が指定されているが、0から100の間の有効な数値ではない場合に返されます。
400	invalid_request_error	無効な music_category。許可される値: corporate, romantic, sports, kids_and_comedy, ambient_and_nature, horror_and_suspense, documentary, trending_vlogs	`music_category`が指定されているが、サポートされている音楽カテゴリのいずれにも一致しない場合に返されます。
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	リクエストが多すぎます	エンドポイントの許容リクエスト率をクライアントが超えた場合に返されます。現在の制限は1分あたり60リクエストです。レート制限は主に x-api-key ヘッダーで指定されたAPIキーごとに適用され、APIキーがない場合はクライアントのIPアドレスに基づいて適用されます。この制限に達したクライアントは、リクエスト頻度を下げ、レート制限ウィンドウがリセットされた後に再試行してください。
429	rate_limit_error	現在、実行中またはキューに登録されているジョブが既に10件あり、これが許可されている最大数です。別のジョブを送信する前にいくつかのジョブが完了するのをお待ちください。	ユーザーが、サーバー上で実行中のジョブとキューに保留中のジョブの両方を合わせて、既に許可されている進行中ジョブの最大数に達している場合に返されます。現在の制限はユーザーあたり合計10件の実行中またはキュー内ジョブです。所有権は、稼働中のサーバーおよび保留中のキューエントリ上の各job_idをジョブのuser_emailに照合して決定されます。この制限に達したクライアントは、別のジョブを作成またはレンダリングする前に既存のジョブが1件以上完了するのを待ってください。
500	api_error	認証エラー	サーバー側で予期せずAPIキーの認証に失敗した場合に返されます。
500	api_error	内部サーバーエラー	status、render、またはハイライトリールの各エンドポイントでの予期せぬサーバー側の障害が発生した場合に返されます。
500	server_error	アップロードURLの生成に失敗しました	サーバーが署名済みアップロードURLの生成に失敗した場合に返されます。