> ## 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 Q3 Turbo テキストから動画生成

Vidu Q3 Turbo テキストから動画生成は、テキスト説明に基づいて同期音声付きの高品質な動画を生成できます。最大 1080p の解像度と 1〜16 秒の長さに対応しています。

<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="seed" type="integer">
  結果を再現可能にするためのランダムシード。未指定または 0 を指定した場合はランダムな値が使用されます。

  値の範囲：\[0, 2147483647]
</ParamField>

<ParamField body="audio" type="boolean" default={true}>
  音声・動画の直接出力機能（セリフと効果音を含む）を使用するかどうか。false：無音動画を出力；true：音声付き動画を出力。Q3 シリーズモデルのみがこのパラメータをサポートします。
</ParamField>

<ParamField body="prompt" type="string" required={true}>
  動画生成のためのテキスト説明。最大 5000 文字。

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

<ParamField body="wm_url" type="string">
  透かし内容の画像 URL。未指定の場合はデフォルトの透かし（内容は AI により生成）を使用します。
</ParamField>

<ParamField body="duration" type="integer" default={5}>
  動画の長さ（秒）。範囲は 1〜16、デフォルトは 5 秒です。

  値の範囲：\[1, 16]
</ParamField>

<ParamField body="off_peak" type="boolean" default={false}>
  オフピークモード。true：オフピークで動画を生成し、消費ポイントを抑えます。タスクは 48 時間以内に生成されます；false：即時に動画を生成します。
</ParamField>

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

<ParamField body="resolution" type="string" default="720p">
  出力動画の解像度。

  指定可能な値：`540p`, `720p`, `1080p`
</ParamField>

<ParamField body="wm_position" type="integer" default={3}>
  透かしの位置：1=左上, 2=右上, 3=右下, 4=左下。デフォルトは 3（右下）。

  値の範囲：\[1, 4]
</ParamField>

<ParamField body="aspect_ratio" type="string" default="16:9">
  出力動画のアスペクト比。

  指定可能な値：`16:9`, `9:16`, `4:3`, `3:4`, `1:1`
</ParamField>

## レスポンス情報

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