bfl/flux-2-max のAPIリファレンス。Black Forest Labs から Comfy Router 経由で提供されています。
クイックスタート
Comfy ワークスペースでキーを作成し、COMFY_API_KEY としてエクスポートします。Python と TypeScript のスニペットは Comfy SDK(pip install comfy-sdk、npm install @comfyorg/sdk)を使用しており、cURL のスニペットは同じ呼び出しを生の HTTP で実行するものです。
モデル ID: bfl/flux-2-max
エンドポイント: POST https://api.comfy.org/v2/models/bfl/flux-2-max
- Wait for the result
- Queue and collect later
スキーマ
入力
integer
デフォルト:"1024"
画像の高さ。範囲:
256 から 2048string
画像から画像への生成に使用する Base64 エンコードされた画像。
string
画像から画像への生成に使用する Base64 エンコードされた画像。
string
画像から画像への生成に使用する Base64 エンコードされた画像。
string
画像から画像への生成に使用する Base64 エンコードされた画像。
string
画像から画像への生成に使用する Base64 エンコードされた画像。
string
画像から画像への生成に使用する Base64 エンコードされた画像。
string
画像から画像への生成に使用する Base64 エンコードされた画像。
string
画像から画像への生成に使用する Base64 エンコードされた画像。
string
画像から画像への生成に使用する Base64 エンコードされた画像。
string
デフォルト:"\"jpeg\""
生成される画像の出力形式。指定可能な値:
jpeg、pngstring
必須
生成する画像のテキスト説明。
boolean
デフォルト:"true"
生成のためにプロンプトを自動的に変更します。
integer
デフォルト:"2"
モデレーションの許容値レベル (Flux 2 Max のみ)。範囲:
0 から 5integer
再現性のためのシード。
integer
デフォルト:"1024"
画像の幅。範囲:
256 から 2048GET /v2/models/bfl/flux-2-max/openapi.json で提供しているスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しの検証に使用するドキュメントと同じものです。
出力
number
プロバイダーが報告するクレジット単位のコスト。タスクが Ready になると設定されます。形式:
floatstring
必須
BFL のタスク識別子。
number
BFL が報告する省略可能な生成の進捗。範囲:
0 から 1形式: floatobject
必須
完了した生成結果。ここでは null 許容ではありません。このコンポーネントの
required エントリは、200 が結果を伴うことを約束するものであり、result を null 許容にすると、単なるキーの存在チェックにまで後退してしまいます。number
プロバイダーが報告する生成のコスト。これは BFL の数値であり、Comfy の請求額ではありません。形式:
doublenumber
プロバイダーが報告する生成時間 (秒単位)。形式:
doublenumber
プロバイダーが報告する生成の完了時刻。Unix エポックからの秒数で表されます。
start_time と同じ理由で double です。形式: doublestring
プロンプトのアップサンプリング後、実際に生成で使用されたプロンプト。
string (uri)
生成されたアセットの署名付き URL。Router はアセットを Comfy のストレージに再ホストしてこのフィールドを書き換えるため、通常は最大 24 時間有効な Comfy ホストの URL になります。発行時に 24 時間の署名が付与され、23 時間のメモから再生されるため、後でのポーリングでは残り 1 時間しかない URL が返されることがあります。再ホストを実行できなかったリーフは、代わりに BFL 自身の短命な配信用 URL を保持します。ビデオでは約 2 時間、画像では約 10 分です。いずれにしてもリンクは失効するため、URL を保存するのではなくアセットをダウンロードしてください。形式:
uriinteger
生成で使用されたシード。指定されたものでもプロバイダーが選択したものでもかまいません。BFL は 2^31 を超えるシード (例: 2784347701) を返すため
int64 として宣言されています。フォーマットされていない integer は、多くの SDK ジェネレーターで 32 ビットフィールドとして生成されてしまいます。形式: int64number
プロバイダーが報告する生成の開始時刻。Unix エポックからの秒数で表されます。
float ではなく double です。現在のエポック値付近では float32 の間隔が約 128 秒になるため、生成全体の期間が単一のデコード値に潰れてしまいます。形式: doublestring
必須
タスクのステータス: Pending、Reasoning、Generating、Ready、Request Moderated、Content Moderated、Error、または Task not found。
例
入力
出力
出荷前の確認
SDK はIdempotency-Key を生成し、自動リトライで再利用します。手動リトライでは元のキーを再利用してください。Router は最大 10 分間接続を保持できます。
リクエストが失敗すると、Router は理由を示す X-Comfy-Error-Type レスポンスヘッダーを送信します。422 は、プロバイダーを呼び出す前に Router が入力を拒否したことを意味します。生成されたアセットは 結果 URL の有効期限 があるため、早めにダウンロードしてください。
ヘッダー
認証、冪等性、リクエスト ID、エラー分類、リトライ間隔、支出上限。
Router API の利用
モデルの検出、バリデーションエラー、リトライ、課金。
制限事項
Router が現在対応していないことと、代替手段。