メインコンテンツへスキップ
POST
/
v3
/
async
/
vidu-2.0-reference2video
Vidu 2.0 参照画像から動画生成
curl --request POST \
  --url https://api.highwayapi.ai/v3/async/vidu-2.0-reference2video \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "images": [
    "<string>"
  ],
  "prompt": "<string>",
  "duration": 123,
  "seed": 123,
  "aspect_ratio": "<string>",
  "resolution": "<string>",
  "movement_amplitude": "<string>",
  "bgm": true
}
'
{
  "task_id": "<string>"
}
Vidu 2.0 の参照画像から動画生成は、参照画像とテキスト説明を使用して動画を生成します。キャラクターやオブジェクトなど、さまざまな主体に対応しています。主体の複数の視点をアップロードすることで、視覚的一貫性を維持した動画を作成できます。
これは非同期API であり、非同期タスクの task_id のみを返します。この task_id を使用して タスク結果照会 API をリクエストし、動画生成結果を取得してください。

リクエストヘッダー

Content-Type
string
必須
列挙値: application/json
Authorization
string
必須
Bearer 認証形式: Bearer {{API Key}}。

リクエストボディ

images
string[]
必須
モデルは提供された画像を参照として使用し、一貫した主体を持つ動画を生成します。画像フィールドの要件:
  • 1〜3 枚の画像を受け付けます
  • 画像リソースは URL または Base64 エンコードで提供できます
  • 次のいずれかの形式を使用する必要があります:PNG、JPEG、JPG、WebP
  • 画像サイズは少なくとも 128x128 ピクセルである必要があります
  • 画像のアスペクト比は 1:4 または 4:1 未満である必要があります
  • すべての画像は 50MB に制限されます
  • base64 デコード後の長さは 10MB 未満である必要があり、適切なコンテンツタイプ文字列を含める必要があります。例:
data:image/png;base64,{base64_encode}
prompt
string
必須
動画生成用のテキストプロンプト。最大長は 1500 文字です。
duration
integer
動画の長さ(秒)。デフォルト:4 秒。選択肢:4
seed
integer
動画生成のランダムシード。
  • デフォルトはランダムなシード値です
  • 手動で設定した値は、デフォルトのランダムシードを上書きします
aspect_ratio
string
出力動画のアスペクト比。デフォルト値:16:9
選択可能な値:16:99:161:1
resolution
string
解像度パラメーターのデフォルトは 360p で、360p720p を選択できます。
movement_amplitude
string
画面内のオブジェクトの動きの大きさ。デフォルト値:auto
選択可能な値:autosmallmediumlarge
bgm
boolean
生成された動画にバックグラウンドミュージックを追加するかどうか。デフォルト値:false
選択可能な値:truefalse
true に設定すると、システムが適切な BGM を自動的に追加します。BGM に長さの制限はなく、システムが自動的に適合させます。

レスポンス情報

task_id
string
必須
非同期タスクの task_id。この task_id を使用して タスク結果照会 API をリクエストし、生成結果を取得してください