> ## 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={true}>
      テキストのポジティブプロンプト。中国語と英語に対応し、最大 2000 文字です。超過部分は自動的に切り捨てられます。

      例：月明かりの下を走る子猫。
    </ParamField>

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

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

      例：低解像度、エラー、最低品質、低品質、欠損、余分な指、比率の不自然さなど。
    </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="size" type="string" required={false}>
      480P、720P、1080P解像度をサポートします。デフォルト値：`1920*1080`（つまり1080P）。
      `size`パラメータは動画出力の解像度を指定するために使用し、形式は幅\*高さです。各解像度グレードでサポートされる具体的な値は次のとおりです：

      **480Pグレード**：選択可能な解像度

      * `832*480`：16:9
      * `480*832`：9:16
      * `624*624`：1:1

      **720Pグレード**：選択可能な解像度

      * `1280*720`：16:9
      * `720*1280`：9:16
      * `960*960`：1:1
      * `1088*832`：4:3
      * `832*1088`：3:4

      **1080Pグレード**：選択可能な解像度

      * `1920*1080`：16:9
      * `1080*1920`：9:16
      * `1440*1440`：1:1
      * `1632*1248`：4:3
      * `1248*1632`：3:4

      <Warning>
        **size パラメータに関するよくある誤解**：具体的な解像度（例：`1280*720`）を入力する必要があり、比率（例：`1:1`）やグレード名（例：`480P`、`720P`）は入力できません。
      </Warning>
    </ParamField>

    <ParamField body="duration" type="integer" required={false}>
      出力動画の長さ。選択可能な値：`5`秒、`10`秒。

      デフォルト値は`5`です。
    </ParamField>

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

      * `true`：デフォルト、スマートリライトを有効化
      * `false`：リライトしない
    </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値を指定できます。
    </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>