luma/photon-1 の API リファレンスです。Comfy Router が Luma から提供しています。
クイックスタート
Comfy ワークスペースでキーを作成し、COMFY_API_KEY としてエクスポートします。Python と TypeScript のスニペットは Comfy SDK(pip install comfy-sdk、npm install @comfyorg/sdk)を使用しています。cURL スニペットは同じ呼び出しを生の HTTP で行うものです。
モデル ID: luma/photon-1
エンドポイント: POST https://api.comfy.org/v2/models/luma/photon-1
- Wait for the result
- Queue and collect later
Schema
入力
string
デフォルト:"\"16:9\""
生成のアスペクト比指定可能な値:
1:1、16:9、9:16、4:3、3:4、21:9、9:21string (uri)
生成のコールバック URL形式:
uriobject
object
画像 identity オブジェクト
string (uri)[]
画像 identity の URL
string
デフォルト:"\"image\""
指定可能な値:
imageobject[]
画像参照オブジェクト
string (uri)
画像参照の URL形式:
urinumber
画像参照の重み
string
生成に使用する画像モデル。Comfy Router のルート
POST /v2/models/luma/{model} では、このフィールドはパスから供給されるため送信してはいけません。v1 の POST /proxy/luma/generations/image ルートでは、LumaImageModel enum(photon-1、photon-flash-1)に制約され、Rewrite は省略されたモデルや不明なモデルを拒否することでこれを強制します。object
modify 画像参照オブジェクト
string (uri)
画像参照の URL形式:
urinumber
modify 画像参照の重み
string
生成のプロンプト
object[]
画像参照オブジェクト
string (uri)
画像参照の URL形式:
urinumber
画像参照の重み
GET /v2/models/luma/photon-1/openapi.json で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する際に使用するドキュメントと同じものです。
出力
object
画像生成のアセットです。
image が結果であり、video と progress_video はこのステータスルートを共有する Dream Machine の VIDEO オペレーションに属するもので、Luma はこれらを明示的な null としてここに送信します。string (uri)
生成された画像の URL です。
luma/photon-* の生成が埋める末端の値にあたります。生成が completed に達するまで null です。フォーマット: uristring (uri)
画像生成では常に null です。これは VIDEO 生成の実行中に Luma が公開する進行中のプレビューです。フォーマット:
uristring (uri)
画像生成では常に null です。代わりに
luma/ray-* のビデオモデルがこれを埋めます。フォーマット: uristring (date-time)
生成が作成された日時フォーマット:
date-timestring
生成の状態の理由
string
生成のタイプです。このオペレーションでは常に
image です取り得る値: imagestring (uuid)
生成の IDフォーマット:
uuidstring
生成に使用されたモデル
object
画像生成リクエストで、ターミナルドキュメント内にエコーバックされたものです。Luma はリクエストモデルのすべてのフィールドをシリアライズし、呼び出し元が設定しなかった各フィールドには明示的な
null を書き込むため、フィールドの存在はキーではなくその値から読み取ってください。string
デフォルト:"\"16:9\""
生成のアスペクト比取り得る値:
1:1, 16:9, 9:16, 4:3, 3:4, 21:9, 9:21string (uri)
生成のコールバック URLフォーマット:
uriobject
object
ターミナルドキュメント内に返ってくる際の画像アイデンティティです。
LumaImageIdentity と同じ形状で、LumaImageRefEcho が示す理由によりそのメンバーは null 許容です。string (uri)[]
画像アイデンティティの URL
string
設定されている場合は常に
image で、オペレーションをエコーします。呼び出し元が送信しなかった場合は null です。これはこのエコーオブジェクト全体が存在する理由と同じです。object[]
ターミナルドキュメント内に返ってくる際の画像参照です。
LumaImageRef と同じ形状で、Luma は未設定のものを省略せず明示的な null としてエコーするため、各メンバーは null 許容です。string (uri)
画像参照の URLフォーマット:
urinumber
画像参照の重み
string
デフォルト:"\"photon-1\""
生成に使用された画像モデル取り得る値:
photon-1, photon-flash-1object
ターミナルドキュメント内に返ってくる際の画像変更参照です。
LumaModifyImageRef と同じ形状で、LumaImageRefEcho が示す理由によりそのメンバーは null 許容です。string (uri)
画像参照の URLフォーマット:
urinumber
画像変更参照の重み
string
生成のプロンプト
object[]
ターミナルドキュメント内に返ってくる際の画像参照です。
LumaImageRef と同じ形状で、Luma は未設定のものを省略せず明示的な null としてエコーするため、各メンバーは null 許容です。string (uri)
画像参照の URLフォーマット:
urinumber
画像参照の重み
string
生成の状態取り得る値:
queued, dreaming, completed, failed例
入力
出力
出荷前の確認
SDK はIdempotency-Key を生成し、自動リトライで再利用します。手動リトライでは元のキーを再利用してください。Router は最大 10 分間接続を保持できます。
リクエストが失敗すると、Router は理由を示す X-Comfy-Error-Type レスポンスヘッダーを送信します。422 は、プロバイダーを呼び出す前に Router が入力を拒否したことを意味します。生成されたアセットは 結果 URL の有効期限 があるため、早めにダウンロードしてください。
ヘッダー
認証、冪等性、リクエスト ID、エラー分類、リトライ間隔、支出上限。
Router API の利用
モデルの検出、バリデーションエラー、リトライ、課金。
制限事項
Router が現在対応していないことと、代替手段。