メインコンテンツへスキップ
POST
/
v3
/
async
/
vidu-q1-reference2video
Vidu Q1 参照画像から動画生成
curl --request POST \
  --url https://api.highwayapi.ai/v3/async/vidu-q1-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 Q1 参照画像から動画生成は、参照画像とテキスト説明を使用して動画を生成します。キャラクターやオブジェクトなど、さまざまな主体に対応しています。主体の複数の視点をアップロードすることで、視覚的一貫性を保った動画を作成できます。
これは非同期API であり、非同期タスクの task_id のみを返します。この task_id を使用して タスク結果照会 API にリクエストし、動画生成結果を取得してください。

リクエストヘッダー

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

リクエストボディ

images
string[]
必須
モデルは提供された画像を参照として使用し、一貫した主体を持つ動画を生成します。画像フィールドの要件:
  • 1〜7 枚の画像を受け付けます
  • 画像リソースは 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
動画の長さ(秒)。デフォルトは 5 秒で、現在は 5 秒オプションのみ対応しています。
seed
integer
動画生成のランダムシード。
  • デフォルトはランダムなシード値です
  • 手動で設定した値はデフォルトのランダムシードを上書きします
aspect_ratio
string
出力動画のアスペクト比。デフォルト値:16:9
使用可能な値:16:99:161:1
resolution
string
出力動画の解像度。デフォルトは 1080p で、現在は 1080p オプションのみ対応しています。
movement_amplitude
string
画面内の物体の動きの大きさ。デフォルト値:auto
使用可能な値:autosmallmediumlarge
bgm
boolean
生成された動画に背景音楽を追加するかどうか。デフォルト値:false
使用可能な値:truefalse
true に設定すると、システムが自動で適切な BGM を追加します。BGM に長さの制限はなく、システムが自動的に適合させます。

レスポンス情報

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