メインコンテンツへスキップ
POST
/
v3
/
async
/
wan2.7-videoedit
万相 Wan 2.7 動画編集
curl --request POST \
  --url https://api.highwayapi.ai/v3/async/wan2.7-videoedit \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "seed": 123,
  "ratio": "<string>",
  "prompt": "<string>",
  "duration": 123,
  "video_url": "<string>",
  "watermark": true,
  "resolution": "<string>",
  "audio_setting": "<string>",
  "prompt_extend": true,
  "negative_prompt": "<string>",
  "reference_image_url": "<string>",
  "reference_image_url_2": "<string>",
  "reference_image_url_3": "<string>"
}
'
{
  "task_id": "<string>"
}
万相 Wan 2.7 動画編集モデルは、マルチモーダル入力（テキスト/画像/動画）に対応し、指示編集および動画移行タスクを実行できます。720P と 1080P の解像度、2〜10 秒の長さに対応し、秒単位で課金されます。出力にはデフォルトで音声が含まれます。
これは非同期API であり、非同期タスクの task_id のみを返します。この task_id を使用して タスク結果照会 API をリクエストし、生成結果を取得してください。

​
リクエストヘッダー

​
Content-Type
string
必須
列挙値: application/json
​
Authorization
string
必須
Bearer 認証形式: Bearer {{API Key}}。

​
リクエストボディ

​
seed
integer
乱数シード。生成結果の再現性を高めるために使用します。値の範囲は [0, 2147483647] です。値の範囲：[0, 2147483647]
​
ratio
string
生成動画のアスペクト比。指定しない場合、入力動画のアスペクト比に近い比率の動画を生成します。720P 対応：16:9(1280720)、9:16(7201280)、1:1(960960)、4:3(1104832)、3:4(8321104)。1080P 対応：16:9(19201080)、9:16(10801920)、1:1(14401440)、4:3(16481248)、3:4(12481648)。選択可能な値：16:9, 9:16, 1:1, 4:3, 3:4
​
prompt
string
テキストプロンプト。動画に対する編集操作を記述するために使用します。中国語と英語に対応し、最大 5000 文字です。例：「画面全体を粘土風に変換する」「動画内の女の子の服を画像内の服に置き換える」。長さ制限：0 - 5000
​
duration
integer
デフォルト:0
生成動画の長さ。単位は秒です。デフォルト値は 0 で、入力動画の長さをそのまま使用することを表します。[2,10] の整数を渡した場合、システムは元動画の 0 秒から指定した長さまでを切り出します。動画をトリミングする必要がある場合のみ設定してください。値の範囲：[0, 10]
​
video_url
string
必須
編集対象の動画 URL。形式は mp4、mov に対応します。長さは 2〜10 秒、解像度の幅と高さは [240,4096] ピクセル、アスペクト比は 1:8〜8:1、ファイルサイズは 100MB 以下です。
​
watermark
boolean
デフォルト:false
ウォーターマークを追加するかどうか。ウォーターマークは動画の右下に配置され、文言は「AI生成」に固定されます。
​
resolution
string
デフォルト:"1080P"
出力動画の解像度レベル。費用に影響します（1080P > 720P）。動画のアスペクト比は入力素材と一致します（ratio パラメータを指定した場合を除く）。選択可能な値：720P, 1080P
​
audio_setting
string
デフォルト:"auto"
動画の音声設定。auto：モデルが prompt の内容に基づいて賢く判断し、プロンプトに音声の記述が含まれる場合は音声を再生成する可能性があり、それ以外の場合は元音声を保持する可能性があります。origin：入力動画の元音声を強制的に保持します。選択可能な値：auto, origin
​
prompt_extend
boolean
デフォルト:true
prompt のスマートリライトを有効にするかどうか。有効にすると、大規模モデルを使用して入力 prompt をスマートにリライトします。短い prompt では生成効果の向上が顕著ですが、処理時間が増加します。
​
negative_prompt
string
ネガティブプロンプト。動画画面に表示したくない内容を記述するために使用します。中国語と英語に対応し、最大 500 文字です。長さ制限：0 - 500
​
reference_image_url
string
参考画像 URL。編集に必要な視覚的参照（衣服の置き換え、スタイル移行など）を提供するために使用できます。形式は JPEG、JPG、PNG（透過チャンネル非対応）、BMP、WEBP に対応します。解像度の幅と高さは [240,8000] ピクセル、アスペクト比は 1:8〜8:1、ファイルサイズは 20MB 以下です。最大 3 枚の参考画像を渡せます。
​
reference_image_url_2
string
2 枚目の参考画像 URL。形式制限は reference_image_url と同じです。
​
reference_image_url_3
string
3 枚目の参考画像 URL。形式制限は reference_image_url と同じです。

​
レスポンス情報

​
task_id
string
task_id を使用して タスク結果照会 API をリクエストし、生成された出力を取得します。