Skip to main content
Wan 2.7 Video Edit の API リファレンス。Wan 2.7 video edit は、テキスト指示に基づいて既存のクリップを書き換え、必要に応じて参照画像でガイドします。

クイックスタート

あなたの Comfy ワークスペースでキーを作成し、COMFY_API_KEY としてエクスポートします。Python と TypeScript のスニペットは Comfy SDK(pip install comfy-sdknpm install @comfyorg/sdk)を使用しています。cURL のスニペットは、同じ呼び出しを生の HTTP で実行するものです。 モデル ID: wan/wan2.7-videoedit エンドポイント: POST https://api.comfy.org/v2/models/wan/wan2.7-videoedit

スキーマ

入力

object
必須
プロンプトなどの基本情報を入力します。
string
オーディオファイルのダウンロードURL。対応形式はmp3とwavです。reference_video_urlsとは併用できません。
string
先頭フレーム画像のURLまたはBase64エンコードデータ。I2Vモデルでは必須です。画像形式はJPEG、JPG、PNG、BMP、WEBP。解像度は360~2000ピクセル。ファイルサイズは最大10MBです。
object[]
wan2.7およびwan3.0モデル用のメディアアセットリスト。ビデオ生成に使用する参照素材(画像、オーディオ、ビデオ)を指定します。各要素には type と url フィールドが含まれます。 対応する type の値はモデルによって異なります:
  • wan2.7-i2v: first_frame、last_frame、driving_audio、first_clip
  • wan2.7-r2v: reference_image、reference_video
  • wan2.7-videoedit: video、reference_image
  • wan3.0-video: first_frame(最大1)、last_frame(最大1)、reference_image(最大10)、 reference_video(最大5クリップ、合計再生時間 <= 15秒)、reference_audio(最大5クリップ、 合計再生時間 <= 15秒)、file(最大1、linkとは併用不可)、link(最大1、fileとは 併用不可)。reference_*/file/link タイプと first_frame/last_frame タイプは 同一リクエスト内で相互排他的です。配列の順序が、プロンプト内のアセットの参照順序 (画像1、ビデオ1、オーディオ1、…)を定義します。
string
必須
メディアアセットのタイプ指定可能な値: first_framelast_framedriving_audiofirst_clipreference_imagereference_videoreference_audiovideofilelink
string
必須
メディアファイルのURL(公開HTTP/HTTPS URLまたはOSS一時URL)
string
ネガティブプロンプト。ビデオ画面に表示したくない内容を記述するために使用します
string
テキストプロンプト。中国語と英語に対応しており、長さは800文字以内です (wan3.0-videoでは最大20,000文字。制限を超えた内容は切り捨てられます)。 複数の参照ビデオを使用するwan2.6-r2vでは、‘character1’、‘character2’ などを使って、 参照ビデオの順序に対応する被写体を参照します。例: 「Character1 sings on the roadside, Character2 dances beside it」 wan3.0-videoの参照モードでは、‘Image 1’、‘Video 1’、‘Audio 1’ などを使って、 media配列内の対応する順序のメディアアセットを参照します。
string[]
wan2.6-r2vモデル専用の参照ビデオURL。1~3本のビデオURLの配列です。 入力の制限:
  • 形式: mp4、mov
  • 本数: 1~3本
  • 単一ビデオの長さ: 2~30秒
  • 単一ファイルサイズ: 最大30MB
  • audio_urlとは併用不可 参照時の再生時間: 単一ビデオは最大5秒、2本の場合は各最大2.5秒、3本の場合は比例してさらに短くなります。 課金: 実際に使用した参照の再生時間に基づきます。
string
ビデオエフェクトのテンプレート名。省略可能です。現在対応しているのは squish、flying、carousel です。使用時はpromptパラメータは無視されます。
string
呼び出すモデルのID。このコンポーネントでは制約されません: Comfy Routerが POST /v2/models/wan/{model}{model} パスセグメントから設定するため、Routerの呼び出し元はこれを省略します。POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis を直接v1で呼び出す場合は必須であり、受け入れられる表記のenumはそのオペレーション自身のコンポーネント WanVideoGenerationRequest にあります。
object
ビデオ処理パラメータ
boolean
デフォルト:"true"
ビデオにオーディオを追加するかどうか
string
デフォルト:"\"auto\""
wan2.7-videoeditモデル用のビデオオーディオ設定。
  • auto(デフォルト): モデルがプロンプト内容に基づいてインテリジェントに判断します
  • origin: 入力ビデオのオリジナルオーディオを強制的に保持します 指定可能な値: autoorigin
integer
デフォルト:"5"
生成されるビデオの長さ(秒):
  • wan2.5モデル: 5秒または10秒
  • wan2.6-t2v、wan2.6-i2v: 5秒、10秒、または15秒
  • wan2.6-r2v: 5秒または10秒のみ(15秒は非対応)
  • wan2.7-i2v、wan2.7-t2v: [2, 15] の整数
  • wan2.7-r2v、wan2.7-videoedit: [2, 10] の整数
  • wan3.0-video: ビデオ入力なしの場合は [2, 30] の整数。ビデオ入力ありの場合は 入力ビデオの合計再生時間 + 出力ビデオの再生時間が30秒を超えてはなりません。-1 は モデルが適切な再生時間を選択するスマート再生時間モードを有効にします 範囲: -130
boolean
デフォルト:"true"
プロンプトのインテリジェントなリライトを有効にするかどうか。デフォルトはtrueです
string
生成されるビデオのアスペクト比。wan2.7およびwan3.0モデル専用です。 wan2.7モデルでは、指定しない場合は解像度ティアに基づいてデフォルトが決まります。 wan3.0-videoでは、adaptive(デフォルト)が入力メディアの比率と意図に基づいて 適切なアスペクト比を自動的に推奨します。指定可能な値: adaptive16:99:161:14:33:4
string
解像度レベル。対応する値はモデルによって異なります:
  • wan2.5-i2v-preview: 480P、720P、1080P
  • wan2.6-i2v: 720P、1080Pのみ(480Pは非対応)
  • wan2.7モデル(i2v、t2v、r2v、videoedit): 720P、1080P(デフォルトは1080P)
  • wan3.0-video、wan3.0-video-prime: 480P、720P、1080P(上流のデフォルトは1080P) このプロキシは、解像度もサイズも指定されていないビデオ生成リクエストを拒否します。 これは、解像度ティアが課金レートを決定するためです。 指定可能な値: 480P720P1080P
integer
乱数シード。モデルが生成するコンテンツのランダム性を制御するために使用します。範囲: 0 から 2147483647
string
デフォルト:"\"single\""
インテリジェントなマルチレンズ制御。prompt_extend が有効な場合にのみ機能します。 wan2.6 および wan2.7-r2v モデル用。
  • single: 単一ショットのビデオ (デフォルト)
  • multi: マルチショットのビデオ 指定可能な値: multisingle
string
widthheight 形式のビデオ解像度。サポートされる解像度はモデルによって異なります: wan2.5 T2V の場合: 480P (480832、832480、624624)、720P、1080P の各サイズ wan2.6 T2V/R2V の場合 (480P なし): 720P: 1280720、7201280、960960、1088832、8321088 1080P: 19201080、10801920、14401440、16321248、12481632
boolean
デフォルト:"false"
ウォーターマークのロゴを追加するかどうか。ウォーターマークは右下隅に配置されます
GET /v2/models/wan/wan2.7-videoedit/openapi.json で Router が提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しの検証に使用するのと同じドキュメントです。

出力

object
必須
string
インテリジェントな書き換え後の実際のプロンプト(ビデオタスク用)
string
オーディオ生成を伴うI2Vタスク用のオーディオURL
string
失敗したリクエストのエラーコード(リクエストが成功した場合は返されません)
string
タスク完了時間
string
失敗したリクエストの詳細情報(リクエストが成功した場合は返されません)
string
オリジナルの入力プロンプト(ビデオタスク用)
object[]
画像生成タスクのタスク結果のリスト
string
インテリジェントな書き換え後の実際のプロンプト(有効な場合)
string
画像のエラーコード(一部のタスクが失敗した場合に返されます)
string
画像のエラー情報(一部のタスクが失敗した場合に返されます)
string
オリジナルの入力プロンプト
string
生成済み画像のURLアドレス
string
タスク実行時間
string
タスク送信時間
string
必須
タスクID
object
画像生成タスクのタスク結果統計
integer
失敗したタスクの数
integer
成功したタスクの数
integer
タスクの総数
string
必須
タスクステータス指定可能な値: PENDINGRUNNINGSUCCEEDEDFAILEDCANCELEDUNKNOWN
string
完了したビデオ生成タスクのビデオURL。リンクの有効期間は24時間です
string
必須
一意のリクエスト識別子
object
出力情報の統計。成功した結果のみがカウントされます
integer
ビデオ解像度レベル(I2Vおよびwan3.0-videoタスク)
number
生成されたビデオの再生時間(秒)(I2Vおよびwan3.0-videoタスク)
integer
生成されたビデオのフレームレート(wan3.0-videoタスク)
integer
生成された画像の数(T2IおよびI2Iタスク)
number
入力ビデオの再生時間(秒)。ビデオ入力がない場合は0.0(wan3.0-videoタスク)
number
出力ビデオの再生時間(秒)(wan3.0-videoタスク)
string
生成されたビデオのアスペクト比。例: 16:9(wan3.0-videoタスク)
string
画像解像度(T2IおよびI2Iタスク)
integer
生成されたビデオの数(T2Vタスク)
number
生成されたビデオの再生時間(秒)(T2Vタスク)
string
ビデオ解像度の比率(T2Vタスク)
string
失敗したリクエストのエラーコード。output の下ではなくエンベロープのルートで報告されます(リクエストが成功した場合は返されません)。
string
失敗したリクエストの詳細情報。output の下ではなくエンベロープのルートで報告されます(リクエストが成功した場合は返されません)。output.message にフォールバックする前にこちらを確認してください。

入力

出力

ビデオの URL は 24 時間有効です。保持する必要がある場合は、速やかにビデオをダウンロードしてください。

出荷前の確認

SDK は Idempotency-Key を生成し、自動リトライで再利用します。手動リトライでは元のキーを再利用してください。Router は最大 10 分間接続を保持できます。 リクエストが失敗すると、Router は理由を示す X-Comfy-Error-Type レスポンスヘッダーを送信します。422 は、プロバイダーを呼び出す前に Router が入力を拒否したことを意味します。生成されたアセットは 結果 URL の有効期限 があるため、早めにダウンロードしてください。

ヘッダー

認証、冪等性、リクエスト ID、エラー分類、リトライ間隔、支出上限。

Router API の利用

モデルの検出、バリデーションエラー、リトライ、課金。

制限事項

Router が現在対応していないことと、代替手段。