> ## 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.7 動画編集

万相 Wan 2.7 動画編集モデルは、マルチモーダル入力（テキスト/画像/動画）に対応し、指示編集および動画移行タスクを実行できます。720P と 1080P の解像度、2〜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="seed" type="integer">
  乱数シード。生成結果の再現性を高めるために使用します。値の範囲は \[0, 2147483647] です。

  値の範囲：\[0, 2147483647]
</ParamField>

<ParamField body="ratio" type="string">
  生成動画のアスペクト比。指定しない場合、入力動画のアスペクト比に近い比率の動画を生成します。720P 対応：16:9(1280*720)、9:16(720*1280)、1:1(960*960)、4:3(1104*832)、3:4(832*1104)。1080P 対応：16:9(1920*1080)、9:16(1080*1920)、1:1(1440*1440)、4:3(1648*1248)、3:4(1248*1648)。

  選択可能な値：`16:9`, `9:16`, `1:1`, `4:3`, `3:4`
</ParamField>

<ParamField body="prompt" type="string">
  テキストプロンプト。動画に対する編集操作を記述するために使用します。中国語と英語に対応し、最大 5000 文字です。例：「画面全体を粘土風に変換する」「動画内の女の子の服を画像内の服に置き換える」。

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

<ParamField body="duration" type="integer" default={0}>
  生成動画の長さ。単位は秒です。デフォルト値は 0 で、入力動画の長さをそのまま使用することを表します。\[2,10] の整数を渡した場合、システムは元動画の 0 秒から指定した長さまでを切り出します。動画をトリミングする必要がある場合のみ設定してください。

  値の範囲：\[0, 10]
</ParamField>

<ParamField body="video_url" type="string" required={true}>
  編集対象の動画 URL。形式は mp4、mov に対応します。長さは 2〜10 秒、解像度の幅と高さは \[240,4096] ピクセル、アスペクト比は 1:8〜8:1、ファイルサイズは 100MB 以下です。
</ParamField>

<ParamField body="watermark" type="boolean" default={false}>
  ウォーターマークを追加するかどうか。ウォーターマークは動画の右下に配置され、文言は「AI生成」に固定されます。
</ParamField>

<ParamField body="resolution" type="string" default="1080P">
  出力動画の解像度レベル。費用に影響します（1080P > 720P）。動画のアスペクト比は入力素材と一致します（ratio パラメータを指定した場合を除く）。

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

<ParamField body="audio_setting" type="string" default="auto">
  動画の音声設定。auto：モデルが prompt の内容に基づいて賢く判断し、プロンプトに音声の記述が含まれる場合は音声を再生成する可能性があり、それ以外の場合は元音声を保持する可能性があります。origin：入力動画の元音声を強制的に保持します。

  選択可能な値：`auto`, `origin`
</ParamField>

<ParamField body="prompt_extend" type="boolean" default={true}>
  prompt のスマートリライトを有効にするかどうか。有効にすると、大規模モデルを使用して入力 prompt をスマートにリライトします。短い prompt では生成効果の向上が顕著ですが、処理時間が増加します。
</ParamField>

<ParamField body="negative_prompt" type="string">
  ネガティブプロンプト。動画画面に表示したくない内容を記述するために使用します。中国語と英語に対応し、最大 500 文字です。

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

<ParamField body="reference_image_url" type="string">
  参考画像 URL。編集に必要な視覚的参照（衣服の置き換え、スタイル移行など）を提供するために使用できます。形式は JPEG、JPG、PNG（透過チャンネル非対応）、BMP、WEBP に対応します。解像度の幅と高さは \[240,8000] ピクセル、アスペクト比は 1:8〜8:1、ファイルサイズは 20MB 以下です。最大 3 枚の参考画像を渡せます。
</ParamField>

<ParamField body="reference_image_url_2" type="string">
  2 枚目の参考画像 URL。形式制限は reference\_image\_url と同じです。
</ParamField>

<ParamField body="reference_image_url_3" type="string">
  3 枚目の参考画像 URL。形式制限は reference\_image\_url と同じです。
</ParamField>

## レスポンス情報

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