Skip to main content
luma/photon-1 の API リファレンスです。Comfy Router が Luma から提供しています。

クイックスタート

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

Schema

入力

string
デフォルト:"\"16:9\""
生成のアスペクト比指定可能な値: 1:116:99:164:33:421:99:21
string (uri)
生成のコールバック URL形式: uri
object
object
画像 identity オブジェクト
string (uri)[]
画像 identity の URL
string
デフォルト:"\"image\""
指定可能な値: image
object[]
画像参照オブジェクト
string (uri)
画像参照の URL形式: uri
number
画像参照の重み
string
生成に使用する画像モデル。Comfy Router のルート POST /v2/models/luma/{model} では、このフィールドはパスから供給されるため送信してはいけません。v1 の POST /proxy/luma/generations/image ルートでは、LumaImageModel enum(photon-1photon-flash-1)に制約され、Rewrite は省略されたモデルや不明なモデルを拒否することでこれを強制します。
object
modify 画像参照オブジェクト
string (uri)
画像参照の URL形式: uri
number
modify 画像参照の重み
string
生成のプロンプト
object[]
画像参照オブジェクト
string (uri)
画像参照の URL形式: uri
number
画像参照の重み
Router が GET /v2/models/luma/photon-1/openapi.json で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する際に使用するドキュメントと同じものです。

出力

object
画像生成のアセットです。image が結果であり、videoprogress_video はこのステータスルートを共有する Dream Machine の VIDEO オペレーションに属するもので、Luma はこれらを明示的な null としてここに送信します。
string (uri)
生成された画像の URL です。luma/photon-* の生成が埋める末端の値にあたります。生成が completed に達するまで null です。フォーマット: uri
string (uri)
画像生成では常に null です。これは VIDEO 生成の実行中に Luma が公開する進行中のプレビューです。フォーマット: uri
string (uri)
画像生成では常に null です。代わりに luma/ray-* のビデオモデルがこれを埋めます。フォーマット: uri
string (date-time)
生成が作成された日時フォーマット: date-time
string
生成の状態の理由
string
生成のタイプです。このオペレーションでは常に image です取り得る値: image
string (uuid)
生成の IDフォーマット: uuid
string
生成に使用されたモデル
object
画像生成リクエストで、ターミナルドキュメント内にエコーバックされたものです。Luma はリクエストモデルのすべてのフィールドをシリアライズし、呼び出し元が設定しなかった各フィールドには明示的な null を書き込むため、フィールドの存在はキーではなくその値から読み取ってください。
string
デフォルト:"\"16:9\""
生成のアスペクト比取り得る値: 1:1, 16:9, 9:16, 4:3, 3:4, 21:9, 9:21
string (uri)
生成のコールバック URLフォーマット: uri
object
object
ターミナルドキュメント内に返ってくる際の画像アイデンティティです。LumaImageIdentity と同じ形状で、LumaImageRefEcho が示す理由によりそのメンバーは null 許容です。
string (uri)[]
画像アイデンティティの URL
string
設定されている場合は常に image で、オペレーションをエコーします。呼び出し元が送信しなかった場合は null です。これはこのエコーオブジェクト全体が存在する理由と同じです。
object[]
ターミナルドキュメント内に返ってくる際の画像参照です。LumaImageRef と同じ形状で、Luma は未設定のものを省略せず明示的な null としてエコーするため、各メンバーは null 許容です。
string (uri)
画像参照の URLフォーマット: uri
number
画像参照の重み
string
デフォルト:"\"photon-1\""
生成に使用された画像モデル取り得る値: photon-1, photon-flash-1
object
ターミナルドキュメント内に返ってくる際の画像変更参照です。LumaModifyImageRef と同じ形状で、LumaImageRefEcho が示す理由によりそのメンバーは null 許容です。
string (uri)
画像参照の URLフォーマット: uri
number
画像変更参照の重み
string
生成のプロンプト
object[]
ターミナルドキュメント内に返ってくる際の画像参照です。LumaImageRef と同じ形状で、Luma は未設定のものを省略せず明示的な null としてエコーするため、各メンバーは null 許容です。
string (uri)
画像参照の URLフォーマット: uri
number
画像参照の重み
string
生成の状態取り得る値: queued, dreaming, completed, failed

入力

出力

出荷前の確認

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

ヘッダー

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

Router API の利用

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

制限事項

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