> ## 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 Pro スマートマルチフレーム

複数のキーフレーム画像から一貫性のある動画を生成します。540p、720p、1080p の 3 種類の解像度に対応しています。

<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 キー}}。
</ParamField>

## リクエストボディ

<ParamField body="wm_url" type="string">
  透かし画像のURL。透かしを有効化しているがカスタム透かしURLを指定しない場合は、デフォルトの透かしが使用されます。透かしを追加しない場合、このパラメータは無効です。
</ParamField>

<ParamField body="payload" type="string">
  パススルーパラメータ。処理は行わず、データ転送のみを行います。最大 1048576 文字。
</ParamField>

<ParamField body="meta_data" type="string">
  メタデータ識別子。JSON形式の文字列。パススルーフィールドです。
</ParamField>

<ParamField body="watermark" type="boolean" default={false}>
  透かしを追加するかどうか。true：透かしを追加；false：透かしを追加しない。デフォルトでは追加しません。
</ParamField>

<ParamField body="resolution" type="string" default="720p">
  動画解像度。デフォルトは 720p です。

  選択可能な値：`540p`, `720p`, `1080p`
</ParamField>

<ParamField body="start_image" type="string" required={true}>
  最初のフレーム画像。画像 Base64 エンコードまたは画像URLを入力できます。入力できる画像は 1 枚のみです。png、jpeg、jpg、webp 形式に対応しています。画像のアスペクト比は 1:4 または 4:1 未満である必要があります。画像サイズは 50 MB を超えないようにしてください。
</ParamField>

<ParamField body="wm_position" type="string" default="bottom_left">
  透かしの位置。デフォルトは左下です。透かしを追加しない場合、このパラメータは無効です。

  選択可能な値：`top_left`, `top_right`, `bottom_right`, `bottom_left`
</ParamField>

<ParamField body="image_settings" type="object[]" required={true}>
  キーフレーム設定配列。各タスクには最少 2 個、最多 9 個のキーフレームが必要です。

  配列長：2 - 9

  <Expandable title="properties" defaultOpen={true}>
    <ParamField body="prompt" type="string">
      前の画像から継続して延長するためのプロンプト。延長される動画内容を制御するために使用します。
    </ParamField>

    <ParamField body="duration" type="integer" default={5}>
      マルチフレームの長さ。異なるキーフレーム間の動画時間です。デフォルトは 5s、選択可能な値は 2～7s です。

      値の範囲：\[2, 7]
    </ParamField>

    <ParamField body="key_image" type="string" required={true}>
      中間フレームの参照画像。モデルはこのパラメータ内の画像を末尾フレームとして動画を生成します。画像 Base64 エンコードまたは画像URLを入力できます。入力できる画像は 1 枚のみです。入力順序がタイムライン順（最初のフレームから末尾フレームまで）になります。png、jpeg、jpg、webp 形式に対応しています。画像のアスペクト比は 1:4 または 4:1 未満である必要があります。画像サイズは 50 MB を超えないようにしてください。
    </ParamField>
  </Expandable>
</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}>
  Provider request ID (optional)
</ResponseField>