Skip to main content
Flux 1.1 Pro Ultra Image の API リファレンス。FLUX 1.1 [pro] は Black Forest Labs のテキストから画像へのモデルです。Ultra モードでは最大 4MP の解像度で画像を生成できます。

クイックスタート

Comfy ワークスペースでキーを作成し、COMFY_API_KEY としてエクスポートします。Python と TypeScript のスニペットは Comfy SDK(pip install comfy-sdknpm install @comfyorg/sdk)を使用します。cURL スニペットは同じ呼び出しを生の HTTP で行うものです。 呼び出したいモデルを選択してください。以下の内容(スニペット、スキーマ、例)はすべて選択したモデルに対応しています。
モデル ID: bfl/flux-pro-1.1-ultraエンドポイント: POST https://api.comfy.org/v2/models/bfl/flux-pro-1.1-ultra

スキーマ

入力

string
デフォルト:"\"16:9\""
画像のアスペクト比。21:9 から 9:21 の間で指定します(例: 16:9)。
string
リミックスするためのオプションの base64 エンコード画像。
number
デフォルト:"0.1"
プロンプトと image prompt のブレンド。0(プロンプトのみ)から 1(image prompt のみ)。範囲: 01
string
デフォルト:"\"jpeg\""
出力画像のフォーマット。指定可能な値: jpegpngwebp
string
必須
画像生成用のテキストプロンプト。
boolean
デフォルト:"false"
プロンプトをアップサンプルするかどうか。有効にすると、より創造的な生成のためにプロンプトが自動的に変更されます。
boolean
デフォルト:"false"
より加工が少なく、自然な見た目の画像を生成します。
integer
デフォルト:"2"
入力と出力のモデレーションに対する許容値。0(最も厳しい)から 6(最も緩い)。範囲: 06
integer
再現性のためのオプションのシード。省略した場合はランダムなシードが使用されます。
string
Webhook 署名検証用のオプションのシークレット。
string (uri)
Webhook 通知を受け取る URL。形式: uri
GET /v2/models/bfl/flux-pro-1.1-ultra/openapi.json で Router が提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証するのと同じドキュメントです。

出力

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

入力

出力

URL は一時的なものです。保存が必要な場合は、速やかに画像をダウンロードしてください。

出荷前の確認

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

ヘッダー

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

Router API の利用

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

制限事項

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