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

始端・終端の 2 枚の画像から、連続性のある動画を高速に生成します。540p、720p、1080p の 3 種類の解像度に対応しています。Turbo バージョンは、生成速度と動画品質のバランスを実現しています。

<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>