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
- Queue and collect later
スキーマ
入力
string
生成に使用するモデル。Comfy Router のルート
POST /v2/models/runway/{model} では、このフィールドはパスから供給されるため送信してはいけません。v1 の POST /proxy/runway/text_to_image ルートでは必須で、gen4_image に制約されています。string
必須
画像生成用のテキストプロンプト
string
必須
指定可能な値:
1920:1080、1080:1920、1024:1024、1360:768、1080:1080、1168:880、1440:1080、1080:1440、1808:768、2112:912object[]
生成をガイドする参照画像の配列
string
必須
エンコードされた画像を含む HTTPS URL またはデータ URI
GET /v2/models/runway/gen4_image/openapi.json で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する対象となるドキュメントと同じものです。
出力
string (date-time)
必須
タスク作成タイムスタンプフォーマット:
date-timestring
必須
タスク ID
string[]
完了した生成のアセット URL。
runway/gen4_image の場合、各要素は画像 URL です。タスクが正常に終了すると含まれます。このリストが結果そのものです。number
タスクの進捗を表す 0 から 1 の間の浮動小数点値。status が RUNNING の場合にのみ利用可能です。範囲:
0 から 1フォーマット: floatstring
必須
Runway タスクで指定可能なステータス。指定可能な値:
SUCCEEDED、RUNNING、FAILED、PENDING、CANCELLED、THROTTLED例
入力
出力
出荷前の確認
SDK はIdempotency-Key を生成し、自動リトライで再利用します。手動リトライでは元のキーを再利用してください。Router は最大 10 分間接続を保持できます。
リクエストが失敗すると、Router は理由を示す X-Comfy-Error-Type レスポンスヘッダーを送信します。422 は、プロバイダーを呼び出す前に Router が入力を拒否したことを意味します。生成されたアセットは 結果 URL の有効期限 があるため、早めにダウンロードしてください。
ヘッダー
認証、冪等性、リクエスト ID、エラー分類、リトライ間隔、支出上限。
Router API の利用
モデルの検出、バリデーションエラー、リトライ、課金。
制限事項
Router が現在対応していないことと、代替手段。