動画を作成

テキストプロンプトと任意の参照画像から非同期タスクを作成し、ステータスの取得と結果のダウンロードに使用する Video ID を返します。

POST/v1/videos

テキストプロンプトと任意の参照画像から非同期動画生成タスクを作成します。API は OpenAI Videos 互換の Multipart リクエストを受け付け、タスクステータスの取得に使用する Video ID を返します。

動画モデルによって、対応する長さ、サイズ、参照画像、拡張パラメーターが異なる場合があります。現在の API Key から参照でき、動画生成に対応するモデル ID を選択してください。

認証

bearerAuth

認証Bearer <token>

Authorization Header に Bearer your-api-key を指定します。

指定位置: header

リクエストボディ

multipart/form-data

Multipart でプロンプト、モデル、任意の参照画像を送信します。Content-Type の boundary はリクエストライブラリに自動生成させてください。

TypeScript 型定義

TypeScript で request body 型を使用します。

prompt*string

生成する動画の内容を記述します。被写体、動作、シーン、カメラワーク、スタイル、品質要件を明確にすることを推奨します。

長さ1 <= length

model?string

使用する動画モデル ID です。現在の API Key から参照でき、動画生成に対応するモデルを選択してください。モデルによって対応する入力方式や拡張パラメーターが異なる場合があります。

長さ1 <= length

seconds?string

動画の長さ（秒）です。デフォルトは 4 です。実際に指定できる長さは選択したモデルによって異なります。

デフォルト値"4"

size?string

出力動画のサイズです。通常は 幅x高さ 形式を使用し、デフォルトは 720x1280 です。実際に指定できるサイズは選択したモデルによって異なります。

デフォルト値"720x1280"

input_reference?file

画像から動画を生成する際にアップロードする参照画像です。一部の互換モデルは直接のファイルアップロードに対応していないため、metadata.img_url で画像 URL を渡す必要があります。

形式binary

metadata?string

プロバイダーまたはモデル固有の拡張パラメーターです。JSON 文字列として送信する必要があります。ここに含まれるフィールドを、すべての動画モデルが対応する共通パラメーターとして扱わないでください。

Wan シリーズの拡張キーには、img_url、first_frame_url、last_frame_url、watermark、prompt_extend、audio、seed、resolution があります。画像 URL は画像からの動画生成、開始・終了フレーム URL はキーフレーム動画に使用します。audio は音声生成に対応するモデルでのみ使用できます。

解像度の選択肢には、480P（832x480、480x832、624x624）、720P（1280x720、720x1280、960x960、1088x832、832x1088）、1080P（1920x1080、1080x1920、1440x1440、1632x1248、1248x1632）があります。実際の対応範囲は選択したモデルに従います。

レスポンスボディ

`application/json`

curl -X POST "https://example.com/v1/videos" \  -F prompt="宇宙服を着た宇宙飛行士が月面を歩いている、高品質、シネマティック" \  -F model="MODEL_ID" \  -F seconds="4" \  -F size="720x1280"

{
  "id": "video_123",
  "object": "video",
  "model": "MODEL_ID",
  "created_at": 1640995200,
  "status": "processing",
  "progress": 0
}

認証

リクエストボディ

レスポンスボディ

201application/json

400application/json

401application/json

403application/json

404application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`