Comfy Router で Gen 4 Image を使用する

Comfy Router 経由で runway/gen4_image を呼び出します: エンドポイント、リクエストの形状、Router が返すレスポンスについて説明します。

runway/gen4_image の API リファレンスです。Comfy Router が Runway から提供します。

​

クイックスタート

Comfy ワークスペースでキーを作成し、COMFY_API_KEY としてエクスポートします。Python と TypeScript のスニペットは Comfy SDK（pip install comfy-sdk、npm install @comfyorg/sdk）を使用しています。cURL のスニペットは、生の HTTP で同じ呼び出しを行うものです。

モデル ID: runway/gen4_image

エンドポイント: POST https://api.comfy.org/v2/models/runway/gen4_image

Wait for the result

Python

from comfy_sdk import Comfy

# Reads COMFY_API_KEY from the environment.
# The SDK automatically creates an idempotency key and reuses it for automatic retries.
with Comfy() as client:
    result = client.models.run(
        "runway/gen4_image",
        {
            "promptText": "a red circle",
            "ratio": "1024:1024",
        },
    )

print(result)

Queue and collect later

Python

from comfy_sdk import Comfy

# Reads COMFY_API_KEY from the environment.
# Each submit() call mints its own Idempotency-Key and reuses it for automatic retries.
with Comfy() as client:
    handle = client.models.submit(
        "runway/gen4_image",
        {
            "promptText": "a red circle",
            "ratio": "1024:1024",
        },
    )
    print("request_id:", handle.request_id)  # with the model ID, all another process needs

    # Poll until the request completes, waiting the Retry-After the server names.
    for update in handle.iter_events():
        print(update.status, update.queue_position)

    # The provider's own payload, the same value models.run() returns.
    # A request that failed or was cancelled raises the typed Router error here.
    result = handle.get()

print(result)

​

スキーマ

​

入力

model · string

生成に使用するモデル。Comfy Router のルート POST /v2/models/runway/{model} では、このフィールドはパスから供給されるため送信してはいけません。v1 の POST /proxy/runway/text_to_image ルートでは必須で、gen4_image に制約されています。

promptText · string · 必須

画像生成用のテキストプロンプト

ratio · string · 必須

指定可能な値: 1920:1080、1080:1920、1024:1024、1360:768、1080:1080、1168:880、1440:1080、1080:1440、1808:768、2112:912

referenceImages · object[]

生成をガイドする参照画像の配列

referenceImages[].uri · string · 必須

エンコードされた画像を含む HTTPS URL またはデータ URI

Router が GET /v2/models/runway/gen4_image/openapi.json で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する対象となるドキュメントと同じものです。

​

出力

createdAt · string (date-time) · 必須

タスク作成タイムスタンプ

フォーマット: date-time

id · string · 必須

タスク ID

output · string[]

完了した生成のアセット URL。runway/gen4_image の場合、各要素は画像 URL です。タスクが正常に終了すると含まれます。このリストが結果そのものです。

progress · number

タスクの進捗を表す 0 から 1 の間の浮動小数点値。status が RUNNING の場合にのみ利用可能です。

範囲: 0 から 1

フォーマット: float

status · string · 必須

Runway タスクで指定可能なステータス。

指定可能な値: SUCCEEDED、RUNNING、FAILED、PENDING、CANCELLED、THROTTLED

​

例

​

入力

{
  "promptText": "a red circle",
  "ratio": "1024:1024"
}

​

出力

{
  "createdAt": "2027-01-01T00:00:00Z",
  "id": "5f7c1b28-9a03-4e61-8d2f-1b2c3d4e5f60",
  "output": [
    "https://example.invalid/runway/gen4_image/generated.png"
  ],
  "status": "SUCCEEDED"
}

​

出荷前の確認

SDK は Idempotency-Key を生成し、自動リトライで再利用します。手動リトライでは元のキーを再利用してください。Router は最大 10 分間接続を保持できます。

リクエストが失敗すると、Router は理由を示す X-Comfy-Error-Type レスポンスヘッダーを送信します。422 は、プロバイダーを呼び出す前に Router が入力を拒否したことを意味します。生成されたアセットは 結果 URL の有効期限 があるため、早めにダウンロードしてください。

ヘッダー

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

Router API の利用

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

制限事項

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