Comfy Router で Wan 2.5 T2V Preview を使う

Wan 2.5 T2V プレビューの API リファレンスです。Wan 2.5 のテキストから動画への生成は、プロンプトのみから短いビデオを作成します。参照画像や参照ビデオは不要です。

クイックスタート

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

結果を待つ
キューに送信して後で回収する

from comfy_sdk import Comfy

# 環境変数から COMFY_API_KEY を読み取ります。
# SDK は自動的に冪等キーを作成し、自動リトライのために再利用します。
with Comfy() as client:
    result = client.models.run(
        "wan/wan2.5-t2v-preview",
        {
            "input": {
                "prompt": "a single red maple leaf falling onto still water, slow motion, shallow depth of field",
            },
            "parameters": {
                "resolution": "720P",
                "duration": 5,
            },
        },
    )

print("video:", result["output"]["video_url"])

import { comfy } from "@comfyorg/sdk";

// 環境変数から COMFY_API_KEY を読み取ります。
// SDK は自動的に冪等キーを作成し、自動リトライのために再利用します。
type Result = { output: { video_url: string } };
const result = await comfy.models.run<Result>("wan/wan2.5-t2v-preview", {
  input: {
    prompt: "a single red maple leaf falling onto still water, slow motion, shallow depth of field",
  },
  parameters: {
    resolution: "720P",
    duration: 5,
  },
});
if (result.kind !== "json") throw new Error("expected a JSON result");

console.log("video:", result.data.output.video_url);

import Foundation
import ComfySwiftSDK

// 環境変数から COMFY_API_KEY を読み取ります。
// SDK は呼び出しごとに冪等キーを生成し、自動リトライのために再利用します。
let client = ComfyCloudClient(apiKey: ProcessInfo.processInfo.environment["COMFY_API_KEY"]!)
let result = try await client.models.run(
    "wan/wan2.5-t2v-preview",
    input: [
        "input": [
            "prompt": "a single red maple leaf falling onto still water, slow motion, shallow depth of field",
        ],
        "parameters": [
            "resolution": "720P",
            "duration": 5,
        ],
    ]
)

print("video:", result.output["output"]["video_url"].stringValue ?? "")

curl https://api.comfy.org/v2/models/wan/wan2.5-t2v-preview \
  -H "X-API-Key: $COMFY_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d "{\"input\": {\"prompt\":\"a single red maple leaf falling onto still water, slow motion, shallow depth of field\"}, \"parameters\": {\"resolution\":\"720P\",\"duration\":5}}"

同じボディを POST https://api.comfy.org/v2/models/wan/wan2.5-t2v-preview/requests に送信します。Router は実行が受け付けられるとすぐに 201 と request_id を返し、結果は準備ができた時点で、このプロセスからでも別のプロセスからでも回収できます。キュー配信では、ステータス、キャンセル、回収の流れを順を追って説明します。

from comfy_sdk import Comfy

# 環境変数から COMFY_API_KEY を読み取ります。
# 各 submit() 呼び出しは独自の Idempotency-Key を発行し、自動リトライのために再利用します。
with Comfy() as client:
    handle = client.models.submit(
        "wan/wan2.5-t2v-preview",
        {
            "input": {
                "prompt": "a single red maple leaf falling onto still water, slow motion, shallow depth of field",
            },
            "parameters": {
                "resolution": "720P",
                "duration": 5,
            },
        },
    )
    print("request_id:", handle.request_id)  # モデル ID と合わせれば、別のプロセスに必要なものはすべて揃います

    # リクエストが完了するまでポーリングし、サーバーが指定する Retry-After の秒数だけ待機します。
    for update in handle.iter_events():
        print(update.status, update.queue_position)

    # プロバイダー自身のペイロードで、models.run() が返すのと同じ値です。
    # 失敗またはキャンセル済みのリクエストは、ここで型付きの Router エラーを発生させます。
    result = handle.get()

print("video:", result["output"]["video_url"])

import { comfy } from "@comfyorg/sdk";

// 環境変数から COMFY_API_KEY を読み取ります。
// 各 submit() 呼び出しは独自の Idempotency-Key を発行し、自動リトライのために再利用します。
type Result = { output: { video_url: string } };
const handle = await comfy.models.submit<Result>("wan/wan2.5-t2v-preview", {
  input: {
    prompt: "a single red maple leaf falling onto still water, slow motion, shallow depth of field",
  },
  parameters: {
    resolution: "720P",
    duration: 5,
  },
});
console.log("requestId:", handle.requestId); // モデル ID と合わせれば、別のプロセスに必要なものはすべて揃います

// リクエストが完了するまでポーリングし、サーバーが指定する Retry-After の秒数だけ待機します。
for await (const update of handle.events()) {
  console.log(update.status, update.queuePosition);
}

// models.run() が返すのと同じ結果です。失敗またはキャンセル済みのリクエストは、ここで reject されます。
const result = await handle.get();
if (result.kind !== "json") throw new Error("expected a JSON result");

console.log("video:", result.data.output.video_url);

import Foundation
import ComfySwiftSDK

// 環境変数から COMFY_API_KEY を読み取ります。
// 各 submit() 呼び出しは独自の Idempotency-Key を発行し、自動リトライのために再利用します。
let client = ComfyCloudClient(apiKey: ProcessInfo.processInfo.environment["COMFY_API_KEY"]!)
let handle = try await client.models.submit(
    "wan/wan2.5-t2v-preview",
    input: [
        "input": [
            "prompt": "a single red maple leaf falling onto still water, slow motion, shallow depth of field",
        ],
        "parameters": [
            "resolution": "720P",
            "duration": 5,
        ],
    ]
)
print("requestId:", handle.requestId)  // モデル ID と合わせれば、別のプロセスに必要なものはすべて揃います

// リクエストが完了するまでポーリングし、サーバーが指定する Retry-After の秒数だけ待機します。
for try await update in handle.events() {
    print(update.state.rawValue, update.queuePosition.map(String.init) ?? "unknown")
}

// プロバイダー自身のペイロードで、models.run() が返すのと同じ値です。
// 失敗またはキャンセル済みのリクエストは、ここで型付きの Router エラーを発生させます。
let result = try await handle.result()

print("video:", result.output["output"]["video_url"].stringValue ?? "")

# 1. 送信します。Router は request_id、status_url、response_url、cancel_url とともに 201 を返します。
curl https://api.comfy.org/v2/models/wan/wan2.5-t2v-preview/requests \
  -H "X-API-Key: $COMFY_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d "{\"input\": {\"prompt\":\"a single red maple leaf falling onto still water, slow motion, shallow depth of field\"}, \"parameters\": {\"resolution\":\"720P\",\"duration\":5}}"

# 2. ステータスが COMPLETED になるまでポーリングし、各レスポンスが指定する Retry-After の秒数だけ待機します。
REQUEST_ID="<request_id from the 201 body>"
curl -i https://api.comfy.org/v2/models/wan/wan2.5-t2v-preview/requests/$REQUEST_ID/status \
  -H "X-API-Key: $COMFY_API_KEY"

# 3. 回収します。モデルのネイティブ出力とともに 200、まだ実行中の場合はステータスボディとともに 202 を返します。
curl https://api.comfy.org/v2/models/wan/wan2.5-t2v-preview/requests/$REQUEST_ID \
  -H "X-API-Key: $COMFY_API_KEY"

スキーマ

入力

object

必須

プロンプトなどの基本情報を入力します。

string

オーディオファイルのダウンロードURL。サポートされる形式: mp3、wav。reference_video_urls とは併用できません。

string

先頭フレーム画像のURL、または Base64 エンコードされたデータ。wan2.5-i2v-preview および wan2.6-i2v モデルでのみ必須です。happyhorse-1.x の i2v 表記は、ここでは先頭フレームを受け取りません。先頭フレームは type が first_frame の media 要素として渡します (下記 media を参照)。wan2.6-i2v で成功する img_url のボディは、happyhorse-1.0-i2v および happyhorse-1.1-i2v ではプロバイダーに拒否されます。画像形式: JPEG、JPG、PNG、BMP、WEBP。解像度: 360～2000ピクセル。ファイルサイズ: 最大10MB。

object[]

wan2.7、wan3.0、happyhorse-1.x モデル用のメディアアセットのリスト。ビデオ生成に使用する参照素材（画像、オーディオ、ビデオ）を指定します。各要素には 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 タイプは同一リクエスト内で同時に使用できません。配列の順序がプロンプト内でのアセットの参照順（Image 1、Video 1、Audio 1、…）を定義します。
happyhorse-1.x-i2v: first_frame のみで、ちょうど 1 つ。少なくとも 300x300 ピクセル、 JPEG/JPG/PNG/WEBP、最大 20MB、公開 URL または data:{MIME_type};base64,… URL。この表記は img_url を一切受け付けません。先頭フレームはここに渡します。
happyhorse-1.x-r2v: reference_image のみで、1〜9 枚。最短辺が少なくとも 400 ピクセル、最大 20MB、公開 URL または data: URL。reference_video はこのオペレーションの入力タイプではありません。
happyhorse-1.x-video-edit: video 上記のアセットごとの「最大 20MB」は、最終的に受け取る画像に対するパートナー側の上限で、アセットが公開 URL の場合はそのまま適用されます。そのバイト列が Comfy を経由しないためです。インラインの data: URL は Comfy を経由するため、転送上限にも直面します。Comfy Router の POST body は合計 100 MiB が上限で、超えると 413 が返ります。base64 はペイロードを約 4/3 に膨らませるため、およそ 75 MB を超える単一のインラインアセットは、ここに示すパートナーのルールに到達する前に拒否されます。そのサイズであれば、パートナー自身の 20MB 上限にある単一のアセットはインラインでも余裕をもって収まります。したがって 1 つのアセットについてはパートナーのルールが制約となります。転送上限が制約となるのは、複数のアセットにまたがる場合です。100 MiB の Router 上限は各要素ではなくリクエスト全体を制限するためです。これらの上限に近いものは公開 URL として送信してください。

string

必須

メディアアセットのタイプ指定可能な値: first_frame、last_frame、driving_audio、first_clip、reference_image、reference_video、reference_audio、video、file、link

string

必須

メディアファイルの URL。公開 HTTP/HTTPS URL、OSS の一時 URL、または (上記 media の説明にあるモデルの項目がそのように述べている場合、たとえば happyhorse-1.x の i2v と r2v の表記のように) インラインの data:{MIME_type};base64,... URL です。モデルごとのサイズとピクセルの下限、およびインラインペイロードを全体として制限する 100 MiB の Router リクエストボディ上限については、その説明を参照してください。

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 の参照モードでは、media 配列内の対応する順序でメディアアセットを参照するために ‘Image 1’、‘Video 1’、‘Audio 1’ などを使用します。

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: 入力ビデオのオリジナルオーディオを強制的に保持します指定可能な値: auto, origin

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 を指定するとスマート再生時間モードが有効になり、モデルが適切な再生時間を選択します範囲: -1 ～ 30

boolean

デフォルト:"true"

プロンプトのインテリジェントな書き換えを有効にするかどうか。デフォルトは true です

string

生成されるビデオのアスペクト比。wan2.7 および wan3.0 モデル専用です。 wan2.7 モデルの場合、指定しないと解像度ティアに基づいてデフォルトが決まります。 wan3.0-video の場合、adaptive（デフォルト）は入力メディアの比率と意図に基づいて適切なアスペクト比を自動的に推奨します。指定可能な値: adaptive, 16:9, 9:16, 1:1, 4:3, 3: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）このプロキシは、resolution と size のどちらも指定されていないビデオ生成リクエストを拒否します。解像度ティアが課金レートを決定するためです。指定可能な値: 480P, 720P, 1080P

integer

乱数シード。モデルが生成するコンテンツのランダム性を制御するために使用します範囲: 0 ～ 2147483647

string

デフォルト:"\"single\""

インテリジェントなマルチレンズ制御。prompt_extend が有効な場合にのみ動作します。 wan2.6 および wan2.7-r2v モデル用です。

single: シングルショットビデオ（デフォルト）
multi: マルチショットビデオ指定可能な値: multi, single

string

幅高さ形式のビデオ解像度。対応する解像度はモデルによって異なります: 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"

ウォーターマークロゴを追加するかどうか。ウォーターマークは右下隅に配置されます

スキーマから生成されており、Router が GET /v2/models/wan/wan2.5-t2v-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

必須

タスクのステータス取りうる値: PENDING、RUNNING、SUCCEEDED、FAILED、CANCELED、UNKNOWN

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 にフォールバックする前にこれを確認してください。

例

入力

{
  "input": {
    "prompt": "a single red maple leaf falling onto still water, slow motion, shallow depth of field"
  },
  "parameters": {
    "resolution": "720P",
    "duration": 5
  }
}

出力

{
  "output": {
    "task_id": "0385dc79-5ff8-4d82-bcb6-7c1a9f2e4d60",
    "task_status": "SUCCEEDED",
    "submit_time": "2027-01-01T00:00:00.000Z",
    "scheduled_time": "2027-01-01T00:00:01.000Z",
    "end_time": "2027-01-01T00:01:04.000Z",
    "orig_prompt": "a single red maple leaf falling onto still water, slow motion, shallow depth of field",
    "actual_prompt": "a single red maple leaf falling onto still water, slow motion, shallow depth of field, soft morning light, gentle ripples spreading outward",
    "video_url": "https://.../generated.mp4"
  },
  "request_id": "7574ee8f-38a3-4b1e-9280-11c33ab46e51",
  "usage": {
    "video_count": 1,
    "video_duration": 5,
    "video_ratio": "1280*720"
  }
}

ビデオ URL の有効期限は 24 時間です。保存しておきたい場合は、速やかにダウンロードしてください。

出荷前の確認

SDK は Idempotency-Key を生成し、自動リトライで再利用します。手動リトライでは元のキーを再利用してください。Router は最大 10 分間接続を保持できます。リクエストが失敗すると、Router は理由を説明する X-Comfy-Error-Type レスポンスヘッダーを送信します。422 は、プロバイダーを呼び出す前に Router が入力を拒否したことを意味し、413 はリクエスト本文が Router の受け入れ可能なサイズを超えていたことを意味します。生成されたアセットは結果 URL の有効期限があるため、早めにダウンロードしてください。上記のフィールド説明に記載されているサイズ制限は、プロバイダーの仕様から引用した、そのフィールドに対するプロバイダー自身の上限です。Router はリクエスト本文全体に対して別の上限を適用し、base64 エンコードされたメディアもこれにカウントされます。リクエスト本文のサイズを参照してください。このページは、Comfy Router 経由で呼び出す 1 つのパートナーモデルについて説明しています。同じ comfy-sdk / @comfyorg/sdk パッケージには、Comfy Cloud 上で ComfyUI のワークフローグラフ全体を実行するための 2 つ目のクライアントも含まれています: Comfy(api_key=...) / new Comfy({ apiKey })、および client.workflows、client.assets、client.jobs。Comfy SDKs を参照してください。

ヘッダー

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

Router API の利用

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

制限事項

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

Comfy で開発する

ワークフローの実行

Comfy Router

Comfy CLI

仕様

Demo Apps

Comfy Router で Wan 2.5 T2V Preview を使う

クイックスタート

スキーマ

入力

出力

例

入力

出力

出荷前の確認

ヘッダー

Router API の利用

制限事項

​クイックスタート

​スキーマ

​入力

​出力

​例

​入力

​出力

​出荷前の確認

ヘッダー

Router API の利用

制限事項

クイックスタート

スキーマ

入力

出力

例

入力

出力

出荷前の確認