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

テキストプロンプトに基づいて動画を生成します。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}>
  BGM を追加するかどうか
</ParamField>

<ParamField body="seed" type="integer">
  乱数シード。生成結果のランダム性を制御するために使用します。同じシードでは類似した結果が生成されます。
</ParamField>

<ParamField body="audio" type="boolean" default={false}>
  音声を生成するかどうか
</ParamField>

<ParamField body="style" type="string">
  動画スタイル。例: cinematic、realistic、artistic など
</ParamField>

<ParamField body="prompt" type="string" required={true}>
  テキストプロンプト。生成したい動画内容を詳細に記述します

  長さ制限：1 - 無制限
</ParamField>

<ParamField body="duration" type="integer" required={true} default={5}>
  動画の長さ（秒）。1〜10 秒をサポート

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

<ParamField body="subjects" type="object[]" default="[]">
  主体リスト。各主体には id、images、voice\_id が含まれます（テキストから動画生成では空にできます）

  <Expandable title="properties" defaultOpen={true}>
    <ParamField body="id" type="string" required={true}>
      主体 ID。prompt 内で @id を使用して参照します
    </ParamField>

    <ParamField body="images" type="string[]" required={true}>
      主体画像 URL リスト

      配列の長さ：1 - 無制限
    </ParamField>

    <ParamField body="voice_id" type="string" default="">
      音声 ID（任意）
    </ParamField>
  </Expandable>
</ParamField>

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

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

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

<ParamField body="aspect_ratio" type="string">
  動画のアスペクト比。例: 16:9、9:16、1:1 など
</ParamField>

<ParamField body="movement_amplitude" type="string">
  モーションの振れ幅。動画内のオブジェクトの動きの強さを制御します

  選択可能な値：`auto`, `small`, `medium`, `high`
</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（任意）
</ResponseField>