> ## 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.

# Wan 2.5 Preview 画像から動画

Wan 2.5 Preview 画像から動画モデルは、先頭フレーム画像とテキストに基づいて 5 秒または 10 秒の動画を生成できます。音声機能が新たに追加され、自動ナレーションに対応するほか、音声ファイルをカスタマイズすることもできます。

<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="input" type="object" required={true}>
  プロンプトなどの基本入力情報。

  <Expandable title="フィールド説明" defaultOpen={true}>
    <ParamField body="prompt" type="string" required={false}>
      テキストのポジティブプロンプト。中国語と英語に対応し、最大 2000 文字です。超過した部分は自動的に切り捨てられます。

      サンプル値：一只小猫在草地上奔跑。
    </ParamField>

    <ParamField body="negative_prompt" type="string" required={false}>
      ネガティブプロンプト。動画生成時に避けたい内容を記述するために使用し、画面内容の回避や制限を行えます。

      中国語と英語に対応し、最大 500 文字です。超過した部分は自動的に切り捨てられます。

      サンプル値：低解像度、エラー、最低品質、低品質、欠損、余分な指、比率不良など。
    </ParamField>

    <ParamField body="img_url" type="string" required={true}>
      動画生成に使用する開始フレーム画像のURL。

      URL は公開アクセス可能で、HTTP または HTTPS プロトコルに対応している必要があります。

      画像の制限：

      * 画像形式：JPEG、JPG、PNG（透明は非対応）、BMP、WEBP；
      * サイズ要件：画像の幅と高さは \[360, 2000] ピクセルの範囲内である必要があります；
      * ファイルサイズは 10MB を超えてはいけません。
    </ParamField>

    <ParamField body="audio_url" type="string" required={false}>
      動画生成に使用する音声ファイルURL。詳細な使用方法は、音声設定の説明を参照してください。

      音声要件：

      * 形式：wav、mp3；
      * 長さ：3〜30 秒；
      * ファイルサイズは 15MB を超えないこと。

      長すぎる場合の処理：音声の長さが対象動画の長さ（例：5 秒または 10 秒）を超える場合、先頭 5 秒または先頭 10 秒のみを保持し、残りの部分は自動的に破棄されます。音声の長さが動画の長さより短い場合、超過部分は無音動画になります。たとえば音声が 3 秒で動画が 5 秒の場合、出力動画の先頭 3 秒には音声があり、後半 2 秒は無音になります。
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="parameters" type="object" required={false}>
  動画処理パラメータ。出力動画の解像度や長さなどを指定します。

  <Expandable title="フィールド説明" defaultOpen={true}>
    <ParamField body="resolution" type="string" required={false}>
      生成動画の解像度ランク。<br />
      選択肢：`480P`、`720P`、`1080P`。デフォルト値：`1080P`。
    </ParamField>

    <ParamField body="duration" type="integer" required={false}>
      生成動画の長さを指定します。対応値：`5` または `10`（単位：秒）。

      デフォルト値：`5`。
    </ParamField>

    <ParamField body="prompt_extend" type="bool" required={false}>
      prompt のスマートリライトを有効にするかどうか。有効にすると、大規模モデルを使用して入力 prompt をスマートにリライトします。短いプロンプトの場合、生成効果を大幅に向上できますが、処理時間も長くなります。

      * `true`：デフォルト。スマートリライトを有効化；
      * `false`：リライトしない。

      サンプル値：true。
    </ParamField>

    <ParamField body="audio" type="boolean" required={false}>
      音声を追加するかどうか。

      パラメータの優先順位：audio\_url > audio。audio\_url が空の場合にのみ有効です。

      * `true`：デフォルト。動画に自動でナレーションを追加；
      * `false`：音声を追加せず、出力は無音動画になります。

      サンプル値：true。
    </ParamField>

    <ParamField body="seed" type="integer" required={false}>
      ランダムシード。モデルが生成する内容のランダム性を制御するために使用します。値の範囲：\[0, 2147483647]。

      未入力の場合はランダム数が自動生成されます。生成結果を比較的安定させたい場合は、同じ seed 値を渡すことができます。

      サンプル値：12345。
    </ParamField>
  </Expandable>
</ParamField>

## レスポンス情報

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