メインコンテンツへスキップ
POST
/
v3
/
async
/
vidu-q2-template2video
VIDU Q2 シーンテンプレート
curl --request POST \
  --url https://api.highwayapi.ai/v3/async/vidu-q2-template2video \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "bgm": true,
  "area": "<string>",
  "seed": 123,
  "beast": "<string>",
  "images": [
    {}
  ],
  "prompt": "<string>",
  "wm_url": "<string>",
  "payload": "<string>",
  "template": "<string>",
  "meta_data": "<string>",
  "watermark": true,
  "wm_position": 123,
  "aspect_ratio": "<string>"
}
'
{
  "task_id": "<string>",
  "provider_request_id": "<string>"
}
シーンテンプレートと入力画像に基づいてエフェクト動画を生成します。複数のシーンテンプレートに対応しており、テンプレートごとにサポートされるエフェクトパラメータが異なります。
これは非同期API であり、非同期タスクの task_id のみを返します。この task_id を使用して タスク結果照会 API にリクエストし、生成結果を取得してください。

​
リクエストヘッダー

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

​
リクエストボディ

​
bgm
boolean
デフォルト:false
生成する動画に BGM を追加するかどうか。デフォルト：false。true を渡すと、システムがプリセット BGM ライブラリから適切な音楽を自動的に選択して追加します。未指定または false の場合、BGM は追加されません。BGM の長さに制限はなく、システムが動画の長さに応じて自動的に調整します
​
area
string
デフォルト:"auto"
異域プリンセスエフェクト専用パラメータ。template に exotic_princess を指定した場合のみ使用できます。デフォルト：auto選択可能な値：auto, denmark, uk, africa, china, mexico, switzerland, russia, italy, korea, thailand, india, japan
​
seed
integer
デフォルト:0
ランダムシード。デフォルトで未指定、または 0 を渡した場合は、ランダムな数値で置き換えられます。手動で設定した場合は、設定したシードが使用されます
​
beast
string
デフォルト:"auto"
ビーストコンパニオンエフェクト専用パラメータ。template に beast_companion を指定した場合のみ使用できます。デフォルト：auto選択可能な値：auto, bear, tiger, elk, snake, lion, wolf
​
images
array
必須
入力画像リスト。モデルはこのパラメータで渡された画像を使用して動画を生成します。画像の Base64 エンコードまたは画像 URL（アクセス可能であることを確認してください）を渡せます。画像は png、jpeg、jpg、webp 形式に対応しています。画像のアスペクト比は 1:4 または 4:1 未満である必要があり、サイズは 50MB を超えてはいけません。Base64 decode 後のバイト長は 10M 未満である必要があり、エンコードには適切なコンテンツタイプ文字列を含める必要があります。例：data:image/png;base64,{base64_encode}配列の長さ：1 - 無制限
​
prompt
string
テキストプロンプト。生成する動画のテキスト説明です。注：template=subject_3、pubg_winner_hit の場合、プロンプトは必須ではありません
​
wm_url
string
ウォーターマーク内容。ここでは画像 URL を指定します。未指定の場合、デフォルトのウォーターマークを使用します：内容は AI によって生成されます
​
payload
string
透過パラメータ。いかなる処理も行わず、データ転送のみを行います。最大 1048576 文字長さ制限：0 - 1048576
​
template
string
必須
シーンテンプレートパラメータ。シーンテンプレートごとに対応する呼び出しパラメータが異なります。一般的なテンプレート：subject_3（人物の衣装変更）、pubg_winner_hit（バトルロイヤル勝利エフェクト）、exotic_princess（異域プリンセス）、beast_companion（ビーストコンパニオン）など。具体的なテンプレートについては、https://platform.vidu.cn/docs/templates を参照してください
​
meta_data
string
メタデータ識別子。json 形式の文字列で、透過フィールドです。形式を自由に定義するか、サンプル形式を使用できます。このパラメータが空の場合、デフォルトで vidu が生成したメタデータ識別子が使用されます。サンプル形式：{"Label": "your_label", "ContentProducer": "your_content_producer", "ContentPropagator": "your_content_propagator", "ProduceID": "your_product_id", "PropagateID": "your_propagate_id", "ReservedCode1": "your_reserved_code1", "ReservedCode2": "your_reserved_code2"}
​
watermark
boolean
デフォルト:false
ウォーターマークを追加するかどうか。true：ウォーターマークを追加；false：ウォーターマークを追加しない。現在、ウォーターマークの内容は固定で、内容は AI によって生成されます。デフォルトでは追加されません。watermarked_url パラメータで、ウォーターマーク付きの動画内容を照会して取得できます
​
wm_position
integer
デフォルト:3
ウォーターマークの位置。画像内でウォーターマークが表示される位置を表します。1：左上；2：右上；3：右下；4：左下。デフォルトは 3選択可能な値：1, 2, 3, 4
​
aspect_ratio
string
デフォルト:"16:9"
動画のアスペクト比。デフォルトは 16:9。選択可能な値：16:9、9:16。template ごとにサポートされる選択可能な値は異なります。詳細はテンプレート説明を参照してください選択可能な値：16:9, 9:16

​
レスポンス情報

​
task_id
string
必須
task_id を使用して タスク結果照会 API にリクエストし、生成された出力を取得します。
​
provider_request_id
string
プロバイダーリクエスト ID（任意）