Skip to main content
bfl/flux-2-max のAPIリファレンス。Black Forest Labs から Comfy Router 経由で提供されています。

クイックスタート

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

スキーマ

入力

integer
デフォルト:"1024"
画像の高さ。範囲: 256 から 2048
string
画像から画像への生成に使用する Base64 エンコードされた画像。
string
画像から画像への生成に使用する Base64 エンコードされた画像。
string
画像から画像への生成に使用する Base64 エンコードされた画像。
string
画像から画像への生成に使用する Base64 エンコードされた画像。
string
画像から画像への生成に使用する Base64 エンコードされた画像。
string
画像から画像への生成に使用する Base64 エンコードされた画像。
string
画像から画像への生成に使用する Base64 エンコードされた画像。
string
画像から画像への生成に使用する Base64 エンコードされた画像。
string
画像から画像への生成に使用する Base64 エンコードされた画像。
string
デフォルト:"\"jpeg\""
生成される画像の出力形式。指定可能な値: jpegpng
string
必須
生成する画像のテキスト説明。
boolean
デフォルト:"true"
生成のためにプロンプトを自動的に変更します。
integer
デフォルト:"2"
モデレーションの許容値レベル (Flux 2 Max のみ)。範囲: 0 から 5
integer
再現性のためのシード。
integer
デフォルト:"1024"
画像の幅。範囲: 256 から 2048
Router が GET /v2/models/bfl/flux-2-max/openapi.json で提供しているスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しの検証に使用するドキュメントと同じものです。

出力

number
プロバイダーが報告するクレジット単位のコスト。タスクが Ready になると設定されます。形式: float
string
必須
BFL のタスク識別子。
number
BFL が報告する省略可能な生成の進捗。範囲: 0 から 1形式: float
object
必須
完了した生成結果。ここでは null 許容ではありません。このコンポーネントの required エントリは、200 が結果を伴うことを約束するものであり、result を null 許容にすると、単なるキーの存在チェックにまで後退してしまいます。
number
プロバイダーが報告する生成のコスト。これは BFL の数値であり、Comfy の請求額ではありません。形式: double
number
プロバイダーが報告する生成時間 (秒単位)。形式: double
number
プロバイダーが報告する生成の完了時刻。Unix エポックからの秒数で表されます。start_time と同じ理由で double です。形式: double
string
プロンプトのアップサンプリング後、実際に生成で使用されたプロンプト。
string (uri)
生成されたアセットの署名付き URL。Router はアセットを Comfy のストレージに再ホストしてこのフィールドを書き換えるため、通常は最大 24 時間有効な Comfy ホストの URL になります。発行時に 24 時間の署名が付与され、23 時間のメモから再生されるため、後でのポーリングでは残り 1 時間しかない URL が返されることがあります。再ホストを実行できなかったリーフは、代わりに BFL 自身の短命な配信用 URL を保持します。ビデオでは約 2 時間、画像では約 10 分です。いずれにしてもリンクは失効するため、URL を保存するのではなくアセットをダウンロードしてください。形式: uri
integer
生成で使用されたシード。指定されたものでもプロバイダーが選択したものでもかまいません。BFL は 2^31 を超えるシード (例: 2784347701) を返すため int64 として宣言されています。フォーマットされていない integer は、多くの SDK ジェネレーターで 32 ビットフィールドとして生成されてしまいます。形式: int64
number
プロバイダーが報告する生成の開始時刻。Unix エポックからの秒数で表されます。float ではなく double です。現在のエポック値付近では float32 の間隔が約 128 秒になるため、生成全体の期間が単一のデコード値に潰れてしまいます。形式: double
string
必須
タスクのステータス: 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 が現在対応していないことと、代替手段。