bfl/flux-2-pro の 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-pro
エンドポイント: POST https://api.comfy.org/v2/models/bfl/flux-2-pro
- Wait for the result
- Queue and collect later
Schema
Input
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-pro/openapi.json で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する対象となるドキュメントと同じものです。
Output
number
プロバイダーが報告するクレジット単位のコスト。タスクが Ready になると設定されます。形式:
floatstring
必須
BFL のタスク識別子。
number
BFL が報告する任意の生成進捗。範囲:
0 から 1形式: floatobject
必須
完了した生成結果。ここでは null 許容ではありません。このコンポーネントの
required エントリは 200 が結果を伴うことを約束するものであり、result を null 許容にすると単なるキーの存在チェックに成り下がってしまいます。number
プロバイダーが報告する生成コスト。これは BFL の数値であり、Comfy の請求額ではありません。形式:
doublenumber
プロバイダーが報告する生成の所要時間(秒)。形式:
doublenumber
プロバイダーが報告する生成の完了時刻。Unix エポックからの秒数です。
double である理由は start_time と同じです。形式: doublestring
実際に生成で使用されたプロンプト(プロンプトのアップサンプリング後)。
string (uri)
生成されたアセットへの署名付き URL。Router はアセットを Comfy のストレージに再ホストしてこのフィールドを書き換えるため、通常は Comfy がホストする最大 24 時間有効な URL になります。発行時に 24 時間分の署名が付与され、23 時間のメモから再生されるため、後でポーリングすると残り 1 時間程度の URL が返ることがあります。再ホストを実行できなかったリーフは、代わりに BFL 自身の短命な配信 URL を保持します(ビデオで約 2 時間、画像で約 10 分)。いずれの場合もリンクは期限切れになるため、URL を保存するのではなくアセットをダウンロードしてください。形式:
uriinteger
生成で使用されたシード(指定されたものか、プロバイダーが選択したものかを問いません)。
int64 として宣言されています。BFL は 2^31 を超えるシード(例: 2784347701)を返すことがあり、フォーマットされていない 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 が現在対応していないことと、代替手段。