> ## 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 画像から動画

Vidu Q3 Pro 画像から動画ツールは、静止画像を動的な動画に変換し、被写体の一貫性を保ちながら、自然な動きとより滑らかなシーンの動的効果を生成します。

<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="string">
  動画のBGM用カスタム音声URL。mp3、wav、m4a、flac 形式に対応。最大 20MB
</ParamField>

<ParamField body="style" type="string" default="general">
  出力のビジュアルスタイル。general は写実スタイル、anime はアニメスタイルです

  選択可能な値：`general`, `anime`
</ParamField>

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

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

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

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

<ParamField body="wm_url" type="string">
  カスタム透かし画像URL。png、jpeg、jpg、webp 形式に対応。最大 10MB
</ParamField>

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

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

<ParamField body="off_peak" type="boolean" default={false}>
  オフピーク時間帯の料金を使用します。true に設定すると、コストを抑えるためにタスクはオフピーク時間帯までキューで待機して処理されます
</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="string">
  動画上の透かしの位置

  選択可能な値：`top-left`, `top-right`, `bottom-left`, `bottom-right`
</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>