Skip to main content
新規連携では 動画生成 と統一 /ai/v1/videos プロトコルを使用してください。本ページの /v1/videos 互換インターフェースとモデルアダプターは引き続き利用できます。呼び出し前に モデル Schema API を照会し、返された path でプロトコルを選択して、その項目の request.schema を確認してください。配列順序には依存しないでください。

現在のモデル一覧

この一覧は現在利用可能なモデルを示すもので、全モデルが同じ入力フィールドに対応することを意味しません。モデル Schema の path でエンドポイントを選び、その項目の request.schema を確認してください。

API 詳細説明

リクエストヘッダー

動画生成タスクの作成

リクエストボディ

モデルによってレスポンス形式に若干の違いがありますが、いずれも id(video_id)と status フィールドを含みます。status でタスクの進捗を判断すればよいです。

レスポンス例(Tongyi Wanxiang/Veo/Jimeng AI)

レスポンス例(Sora)

共通ステータス値の説明

動画ステータスの照会

このインターフェースをポーリングしてタスクが完了したか確認します。15 秒 ごとに照会することを推奨します。

レスポンス例(生成完了 - Tongyi Wanxiang)

レスポンス例(生成完了 - Sora)

すべてのモデルは status == "completed" で完了状態を判断し、その後 /content インターフェースを呼び出してダウンロードします。

動画コンテンツのダウンロード

ステータスが completed になったら、このインターフェースを呼び出して MP4 動画ファイルをダウンロードします。 レスポンス: 動画のバイナリストリームを直接返します(Content-Type: video/mp4)。
注意:動画のダウンロードリンクは通常 24 時間の有効期限があります。速やかにダウンロードして保存してください。

動画タスクの削除

このインターフェースは作成済みの動画タスクを削除するために使用します。

各モデルのパラメータ詳細

OpenAI Sora

ヒント:すべてのモデルの seconds パラメータは統一して文字列型で渡します(例:"8")。
サンプル

Google Veo

サンプル
画像フィールドに関する注意:
  • 先頭フレームの優先順位:first_frame > input_reference(OpenAI 互換の単一フレーム)。
  • first_frame / last_frame / reference_images の各要素には、公開 URL、base64 データ URL(data:image/png;base64,...)、または {"mime_type":"image/png","data":"<base64>"} オブジェクトを指定できます。
  • OpenRouter 形式の frame_images(frame_type: first_frame | last_frame を持つ要素)および input_references エイリアスも受け付けます。
  • 参照画像は最大 3 枚まで;これを超えると 400 を返します。
ヒント:Veo はネイティブ音声生成をサポートしており、prompt 内で効果音を記述できます。例:「背景に鳥のさえずりが聞こえる」「ピアノの旋律」。

Tongyi Wanxiang

各モデルがサポートする長さ サポートされる解像度(幅*高さ)
注意:wan2.6 は 720P と 1080P のみサポート;wan2.5 は 480P、720P、1080P をサポート;wan2.2 は 480P と 1080P のみサポート。
サンプル
ヒント:wan2.5 以上のバージョンはデフォルトで音声付き動画を生成します(自動吹き替え)。中国語の prompt の方が効果が高いです。

Doubao Seedance

実在人物の素材を使用する前に素材グループの作成、本人による確認、素材の登録を完了し、既存の互換クライアントでは実在人物の素材を使う互換プロトコルの例を参照してください。 extra_body.content がサポートする参照タイプ サンプル
Seedance 2.0 / 2.0 Fast

Kling

この一覧は現在利用可能なモデルを示すもので、全モデルが同じ入力フィールドに対応することを意味しません。モデル Schema の path でエンドポイントを選び、その項目の request.schema を確認してください。

完全な呼び出しサンプル

FAQ

動画生成にはどのくらい時間がかかりますか?

動画生成は通常 1-5 分かかり、具体的な時間はモデル、解像度、長さによって異なります。15 秒のポーリング間隔を設定することを推奨します。

input_reference パラメータはどう使いますか?

input_reference は画像から動画のシナリオで使用し、3種類の渡し方をサポートします:

動画ダウンロードリンクの有効期限はどのくらいですか?

生成された動画のダウンロードリンクは通常 24 時間 の有効期限があります。速やかにダウンロードして保存してください。

各モデルのseconds パラメータにはどんな違いがありますか?

> ヒント:すべてのモデルの seconds パラメータは統一して文字列型で渡します(例:"8")。API が自動的に処理します。

モデルによってsize パラメータの形式にはどんな違いがありますか?

### seconds と duration にはどんな違いがありますか? 両者の意味は同じで、どちらも動画の長さを表します。API はこの両方のパラメータ名をサポートしています(Sora を除く。Sora は seconds のみ受け付けます)。統一して seconds を使用することを推奨します。

より良い prompt を書くには?

  • 具体的なシーンを描写する:主体、動作、環境、光線、雰囲気を含める
  • カメラの言語を指定する:例「クローズアップ」「空撮」「ズームイン」「スローモーション」
  • スタイルを描写する:例「映画的」「ドキュメンタリー風」「アニメ風」
  • 中国語モデルには中国語 prompt の方が効果的:Tongyi Wanxiang は中国語に最適化されている
  • Veo は音声記述をサポート:prompt 内で音を記述できる、例「鳥のさえずり」「ピアノの旋律」

エラーレスポンスと互換エラーコード

本節は、このページの Legacy /v1/videos/* エンドポイントに適用されます。新しい /ai/v1/videos/* エンドポイントでは、独立した 動画エラーコントラクト を使用します。 2 つのインターフェースのレスポンス構造とエラーコードは、それぞれ別に処理してください。 Legacy 動画エンドポイントの一般的な HTTP エラーレスポンスは次のとおりです。通常のエラーでは code と param は返されず、tid は通常 message の末尾に付加されます。

HTTP 5xx エラーのフィードバックを送信

リクエストが HTTP 5xx を返した場合にのみ、message 内の tid を添えてフィードバックを送信してください。

HTTP 200 + status=failed

照会リクエストが成功しても、動画タスクが failed の場合は HTTP 200 が返されることがあります。 この場合、error にはモデルプロバイダーが提供する動的な message が含まれ、通常のタスク失敗には 安定した code がありません。
message がパラメータ、コンテンツポリシー、またはメディア入力の問題を明確に示す場合は、 対応する入力を修正してから新しいタスクを作成してください。原因が不明な場合は、動画 ID が 対応する診断識別子です。
最終更新:2026-09-01