> ## 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 Pro テキストから動画

これは非同期 API であり、非同期タスクの `task_id` のみを返します。

<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="seed" type="integer">
  結果の再現性のためのランダムシード。0 を使用するとランダムになります。

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

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

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

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

<ParamField body="wm_url" type="string">
  ウォーターマーク画像 URL。
</ParamField>

<ParamField body="duration" type="integer" default={5}>
  動画の長さ（秒）。範囲は 1-16。

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

<ParamField body="off_peak" type="boolean" default={false}>
  オフピークモードを使用します。タスクは 48 時間以内に処理され、費用はより低くなります。
</ParamField>

<ParamField body="watermark" type="boolean" default={false}>
  ウォーターマークを追加するかどうか。
</ParamField>

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

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

<ParamField body="wm_position" type="integer">
  ウォーターマークの位置：1=左上, 2=右上, 3=左下, 4=右下。

  値の範囲：\[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>