Skip to main content
wan/wan2.5-i2i-preview の API リファレンス。Wan の Comfy Router から提供されます。

クイックスタート

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

Schema

入力

object
必須
プロンプト、画像などの基本情報を入力します。
string[]
必須
画像から画像への生成に使用する画像 URL の配列
string
画像に表示したくないコンテンツを記述するネガティブプロンプト
string
必須
期待する画像の要素や視覚的特徴を記述するポジティブプロンプト。中国語と英語をサポートし、長さは 2000 文字以内です
string
画像から画像への生成に呼び出すモデルの ID。このコンポーネントでは制約されません。Comfy Router が POST /v2/models/wan/{model}{model} パスセグメントから設定します。POST /proxy/wan/api/v1/services/aigc/image2image/image-synthesis への直接の v1 呼び出しではこれを必ず指定する必要があり、受け入れられる表記の enum はそのオペレーション自身のコンポーネント WanImage2ImageGenerationRequest にあります。
object
画像処理パラメータ
integer
デフォルト:"1"
生成する画像の数。範囲は 1~4、デフォルトは 1範囲: 14
integer
ランダム性を制御する乱数シード。範囲 [0, 2147483647]範囲: 02147483647
string
デフォルト:"\"1280*1280\""
高さ形式の出力画像の解像度。デフォルトは 12801280 です。API は 589824 (768768) から 1638400 (12801280) までのピクセル面積を、1:4 から 4:1 までのアスペクト比で受け付けます
boolean
デフォルト:"false"
右下隅に透かしロゴを追加するかどうか
Router が GET /v2/models/wan/wan2.5-i2i-preview/openapi.json で提供するスキーマから生成されます。これは、リクエストがプロバイダーに到達する前に呼び出しを検証する際に使用するのと同じドキュメントです。

出力

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 の下ではなく、エンベロープの ROOT で報告されます(リクエストが成功した場合は返されません)。
string
失敗したリクエストの詳細情報。output の下ではなく、エンベロープの ROOT で報告されます(リクエストが成功した場合は返されません)。output.message にフォールバックする前にこちらを確認してください。

入力

出力

出荷前の確認

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

ヘッダー

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

Router API の利用

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

制限事項

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