> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jiekou.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# VIDU Q2 シーンテンプレート

シーンテンプレートと入力画像に基づいてエフェクト動画を生成します。複数のシーンテンプレートに対応しており、テンプレートごとにサポートされるエフェクトパラメータが異なります。

<Tip>
  これは**非同期**API であり、非同期タスクの task\_id のみを返します。この task\_id を使用して [タスク結果照会 API](/ja/docs/models/reference-get-async-task-result) にリクエストし、生成結果を取得してください。
</Tip>

## リクエストヘッダー

<ParamField header="Content-Type" type="string" required={true}>
  列挙値: `application/json`
</ParamField>

<ParamField header="Authorization" type="string" required={true}>
  Bearer 認証形式: Bearer \{\{API Key}}。
</ParamField>

## リクエストボディ

<ParamField body="bgm" type="boolean" default={false}>
  生成する動画に BGM を追加するかどうか。デフォルト：false。true を渡すと、システムがプリセット BGM ライブラリから適切な音楽を自動的に選択して追加します。未指定または false の場合、BGM は追加されません。BGM の長さに制限はなく、システムが動画の長さに応じて自動的に調整します
</ParamField>

<ParamField body="area" type="string" default="auto">
  異域プリンセスエフェクト専用パラメータ。template に exotic\_princess を指定した場合のみ使用できます。デフォルト：auto

  選択可能な値：`auto`, `denmark`, `uk`, `africa`, `china`, `mexico`, `switzerland`, `russia`, `italy`, `korea`, `thailand`, `india`, `japan`
</ParamField>

<ParamField body="seed" type="integer" default={0}>
  ランダムシード。デフォルトで未指定、または 0 を渡した場合は、ランダムな数値で置き換えられます。手動で設定した場合は、設定したシードが使用されます
</ParamField>

<ParamField body="beast" type="string" default="auto">
  ビーストコンパニオンエフェクト専用パラメータ。template に beast\_companion を指定した場合のみ使用できます。デフォルト：auto

  選択可能な値：`auto`, `bear`, `tiger`, `elk`, `snake`, `lion`, `wolf`
</ParamField>

<ParamField body="images" type="string[]" required={true}>
  入力画像リスト。モデルはこのパラメータで渡された画像を使用して動画を生成します。画像の Base64 エンコードまたは画像 URL（アクセス可能であることを確認してください）を渡せます。画像は png、jpeg、jpg、webp 形式に対応しています。画像のアスペクト比は 1:4 または 4:1 未満である必要があり、サイズは 50MB を超えてはいけません。Base64 decode 後のバイト長は 10M 未満である必要があり、エンコードには適切なコンテンツタイプ文字列を含める必要があります。例：`data:image/png;base64,{base64_encode}`

  配列の長さ：1 - 無制限
</ParamField>

<ParamField body="prompt" type="string">
  テキストプロンプト。生成する動画のテキスト説明です。注：template=subject\_3、pubg\_winner\_hit の場合、プロンプトは必須ではありません
</ParamField>

<ParamField body="wm_url" type="string">
  ウォーターマーク内容。ここでは画像 URL を指定します。未指定の場合、デフォルトのウォーターマークを使用します：内容は AI によって生成されます
</ParamField>

<ParamField body="payload" type="string">
  透過パラメータ。いかなる処理も行わず、データ転送のみを行います。最大 1048576 文字

  長さ制限：0 - 1048576
</ParamField>

<ParamField body="template" type="string" required={true}>
  シーンテンプレートパラメータ。シーンテンプレートごとに対応する呼び出しパラメータが異なります。一般的なテンプレート：subject\_3（人物の衣装変更）、pubg\_winner\_hit（バトルロイヤル勝利エフェクト）、exotic\_princess（異域プリンセス）、beast\_companion（ビーストコンパニオン）など。具体的なテンプレートについては、[https://platform.vidu.cn/docs/templates](https://platform.vidu.cn/docs/templates) を参照してください
</ParamField>

<ParamField body="meta_data" type="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"}`
</ParamField>

<ParamField body="watermark" type="boolean" default={false}>
  ウォーターマークを追加するかどうか。true：ウォーターマークを追加；false：ウォーターマークを追加しない。現在、ウォーターマークの内容は固定で、内容は AI によって生成されます。デフォルトでは追加されません。watermarked\_url パラメータで、ウォーターマーク付きの動画内容を照会して取得できます
</ParamField>

<ParamField body="wm_position" type="integer" default={3}>
  ウォーターマークの位置。画像内でウォーターマークが表示される位置を表します。1：左上；2：右上；3：右下；4：左下。デフォルトは 3

  選択可能な値：`1`, `2`, `3`, `4`
</ParamField>

<ParamField body="aspect_ratio" type="string" default="16:9">
  動画のアスペクト比。デフォルトは 16:9。選択可能な値：16:9、9:16。template ごとにサポートされる選択可能な値は異なります。詳細はテンプレート説明を参照してください

  選択可能な値：`16:9`, `9:16`
</ParamField>

## レスポンス情報

<ResponseField name="task_id" type="string" required={true}>
  task\_id を使用して [タスク結果照会 API](/ja/docs/models/reference-get-async-task-result) にリクエストし、生成された出力を取得します。
</ResponseField>

<ResponseField name="provider_request_id" type="string" required={false}>
  プロバイダーリクエスト ID（任意）
</ResponseField>