> ## 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 画像から動画への変換ツールは、静止画像を動的な動画に変換できます。テキストによるモーション生成のガイドに対応し、複数の解像度とアスペクト比を選択できます。

<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}>
  音声付き動画を直接出力する機能を使用するかどうか。true に設定すると、セリフおよび背景音付きの動画を出力します。Q3 モデルのデフォルトは true です。
</ParamField>

<ParamField body="images" type="string[]" required={true}>
  参照画像 URL の配列。`.jpg`、`.jpeg`、`.png`、`.webp` に対応しています。
  各画像のサイズは 50MB 以下で、アスペクト比は 1:4 から 4:1 の間である必要があります。
</ParamField>

<ParamField body="is_rec" type="boolean" default={false}>
  音画マッチングを有効にします。true に設定すると、音声のリズムと動画の動きが同期します。
</ParamField>

<ParamField body="prompt" type="string">
  動画生成のモーション説明。シーンの動き、アクション、動的効果を記述します。

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

<ParamField body="duration" type="integer" default={5}>
  動画の長さ（秒）。

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

<ParamField body="off_peak" type="boolean" default={false}>
  オフピーク時間帯の料金を使用します。true に設定すると、コスト削減のため、タスクはオフピーク時間帯の処理を待機するキューに入ります。
</ParamField>

<ParamField body="audio_type" type="string" default="all">
  音声タイプ。audio が true の場合に有効です。all = 音響効果+音声、speech\_only = 音声のみ、sound\_effect\_only = 音響効果のみ。

  選択可能な値：`all`, `speech_only`, `sound_effect_only`
</ParamField>

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

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

## レスポンス情報

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