> ## 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 始端・終端フレーム

始端と終端の2フレーム画像から、一貫性のある動画を生成します。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 Key}}。
</ParamField>

## リクエストボディ

<ParamField body="bgm" type="boolean" default={false}>
  生成される動画にバックグラウンドミュージックを追加するかどうか。true: システムがプリセット BGM ライブラリから適切な音楽を自動的に選択して追加します。false: BGM を追加しません。BGM の長さに制限はなく、システムが動画の長さに応じて自動的に調整します。
</ParamField>

<ParamField body="seed" type="integer">
  ランダムシード。デフォルトで未指定、または0を指定した場合は、ランダムな数値が代わりに使用されます。手動で設定した場合は、設定されたシードが使用されます。
</ParamField>

<ParamField body="images" type="string[]" required={true}>
  画像配列。1枚目の画像は始端フレーム画像、2枚目の画像は終端フレーム画像として扱われ、モデルはこのパラメータで渡された画像を使用して動画を生成します。2枚の画像の入力に対応しています。注1: 始端・終端フレームの2枚の入力画像の解像度は近い必要があり、始端フレーム画像の解像度/終端フレーム画像の解像度は0.8～1.25の範囲内である必要があります。注2: 画像の Base64 エンコードまたは画像URL（アクセス可能であることを確認してください）の入力に対応しています。注3: 画像は png、jpeg、jpg、webp形式に対応しています。注4: 画像サイズは50Mを超えてはいけません。注5: Base64エンコードには、適切なコンテンツタイプ文字列を含める必要があります。例：data:image/png;base64,{base64_encode}

  配列長：2 - 2
</ParamField>

<ParamField body="is_rec" type="boolean" default={false}>
  推奨プロンプトを使用するかどうか。true：使用する。システムが自動的にプロンプトを推奨し、そのプロンプト内容を使用して動画を生成します（タスクごとに追加で10クレジットを消費）。false：使用しない。入力されたpromptに基づいて動画を生成します
</ParamField>

<ParamField body="prompt" type="string">
  テキストプロンプト。動画生成のためのテキスト説明です。注1：文字数は 2000 文字を超えてはいけません。注2：is\_rec推奨プロンプトパラメータを使用する場合、モデルはこのパラメータに入力されたプロンプトを考慮しません

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

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

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

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

<ParamField body="duration" type="integer" default={5}>
  動画の長さ（秒）。1～8 秒に対応

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

<ParamField body="off_peak" type="boolean" default={false}>
  オフピークモード。true：オフピークで動画を生成します（消費クレジットが少なく、48時間以内に生成）。false：即時に動画を生成します。注：オフピークモードで送信されたタスクのうち、完了しなかったタスクは自動的にキャンセルされ、クレジットが返還されます。オフピークタスクを手動でキャンセルすることもできます。
</ParamField>

<ParamField body="meta_data" type="string">
  メタデータ識別子。json形式の文字列、透過フィールドです。形式をカスタマイズするか、サンプル形式を使用できます。このパラメータが空の場合、デフォルトでviduが生成したメタデータ識別子が使用されます。
</ParamField>

<ParamField body="watermark" type="boolean" default={false}>
  ウォーターマークを追加するかどうか。デフォルトではウォーターマークは追加されません。watermarked\_urlパラメータを使用して、ウォーターマーク付きの動画コンテンツを照会して取得できます。
</ParamField>

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

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

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

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

<ParamField body="movement_amplitude" type="string" default="auto">
  動きの大きさ。動画内のオブジェクトの動きの強度を制御します

  選択可能な値：`auto`, `small`, `medium`, `large`
</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>