FLUX 3 Image API
Black Forest Labs の FLUX 3 Image は生成制御をピクセル単位へ進めました。各要素をバウンディングボックスで配置し、ボックス単位で編集しても未触碰領域はピクセルレベルで保持。ネイティブ出力は 768sq から 4K まで。Roko API では非同期タスクで、768sq が 1 リクエスト $0.041 から利用できます。
- 公開モデル ID
flux-3-image- 出力段階
768sq / 1K / 1.5K / 2K / 4K（既定 1K）- 課金方式
リクエスト × 選択解像度- エンドポイント
POST /v1/images/tasks- カタログスナップショット
FLUX 3 Image とは？
FLUX 3 Image は Black Forest Labs が 2026 年 10 月 1 日に公開した画像生成・編集モデルで、公式のキャッチコピーは「すべてのピクセルを制御する」です。差別化ポイントはバウンディングボックスレイアウト：キャンバスを 0〜1000 の正規化座標グリッドに抽象化し、プロンプト末尾で各要素にボックスと説明を与えると、生成結果がその位置制約を満たします。
編集もボックス単位で行えます。完成画像への変更をボックスごとに複数ラウンドで実施し、編集したボックスの外側はピクセルレベルで変化しません。最大 10 枚の参照画像（プロンプト内で位置づけで命名）と、grounding によるウェブ検索補完にも対応します。
Roko API では現在 768sq・1K・1.5K・2K・4K の 5 段階と 16 種類のアスペクト比を公開し、選択した解像度でリクエスト単位に課金されます（768sq $0.041 〜 4K $0.607）。確認時は BFL の定価と同額でしたが、Roko の請求は常に現在のプロジェクトカタログが基準です。呼び出しは非同期タスクで、task_id を受け取ってからポーリングします。
主な能力
バウンディングボックスレイアウト
正規化座標グリッドで各要素を配置し、ボックスごとに記述。生成を「プロンプトの正確さ」から「レイアウトの正確さ」の問題に変えます。
ボックス単位の部分編集
完成画像をボックスごとに複数ラウンドで修正。未触碰領域はピクセルレベルで保持され、全体のドリフトを防ぎます。
10 枚の参照画像を融合
最大 10 枚の参照画像を組み合わせ、プロンプト内で位置づけで命名。モデルが配置を決めて一体でレンダリングします。
ネイティブ 4K と 16 比率
768sq から 4K（約 16.8 メガピクセル）まで 5 段階のネイティブ解像度と 16 種類のアスペクト比。4K は拡大後も細部を保持します。
FLUX 3 Image API の料金
料金は現在の Roko カタログから生成され、選択した解像度でリクエスト単位に課金されます。検証時は BFL 定価と同額でしたが、上流の価格やキャンペーンは Roko の請求を決めません。送信時の Roko 見積りと最終決済をご確認ください。
| 解像度 | 料金 | 課金単位 |
|---|---|---|
| 768sq | $0.041 | 1 枚あたり |
| 1k | $0.048 | 1 枚あたり |
| 1.5k | $0.07 | 1 枚あたり |
| 2k | $0.1 | 1 枚あたり |
| 4k | $0.607 | 1 枚あたり |
費用例
既定段階。ウェブ・SNS 素材の標準コストです。
ネイティブ最高段階。印刷や大型出力に。失敗リクエストは課金されません。
パラメータと対応範囲
これらのフィールドは現在公開されている generation_config から取得しています。バウンディングボックス構文はプロンプト末尾に記述します（0〜1000 正規化座標）。フォーム外の能力はリクエスト時のバリデーションによります。
| パラメータ | 値 | 説明 |
|---|---|---|
prompt | textarea | 生成したい画像や、参照画像への変更内容を記述します。 · 必須 |
images | url / base64 · 1–10 | 参照画像は URL または Base64 で指定します。上限は現在のモデル項目に表示されます。 · 任意 |
aspect_ratio | auto / 21:9 / 2:1 / 16:9 / 3:2 / 7:5 / 4:3 / 5:4 / 1:1 / 4:5 / 3:4 / 5:7 / 2:3 / 9:16 / 1:2 / 9:21 | 出力アスペクト比を選択します。auto はモデルに任せます。 · デフォルト: auto · 任意 |
resolution | 768sq / 1k / 1.5k / 2k / 4k | このモデルで設定された出力解像度を選択します。値によって料金が変わる場合があります。 · デフォルト: 1k · 任意 |
safety_tolerance | 0–4 | Roko では現在 0〜4 を公開しています。0 が最も厳しく、4 が最も寛容です。既定は 2 です。 · デフォルト: 2 · 任意 |
grounding | boolean | 有効にするとモデルがウェブ検索でプロンプトを補完します。既定はオンです。 · デフォルト: true · 任意 |
Roko API で FLUX 3 Image を呼び出す
非同期タスクフローで実行します。タスクを送信して task_id を受け取り、結果をポーリングします。API キーをフロントエンドに露出させないでください。
生成を送信
curl https://api.rokoapi.com/v1/images/tasks \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: YOUR_UNIQUE_REQUEST_ID" \
-d '{
"model": "flux-3-image",
"prompt": "Modern city park poster: bounding boxes — fountain center (400,500)-(600,800), skyscrapers background left (0,0)-(350,700), oak trees background right (650,100)-(1000,750)",
"aspect_ratio": "16:9",
"resolution": "1k"
}'復元タスクを照会
curl https://api.rokoapi.com/v1/tasks/$TASK_ID \
-H "Authorization: Bearer $API_KEY"POST /v1/images/tasks は 202 と task_id を返します。生成完了後、GET /v1/tasks/{task_id} で結果または失敗理由を照会します。Idempotency-Key は一意である必要があり、同じキーの再送は元のタスクを返し、重複課金されません。
適したシーン
正確な構図のレイアウト・ポスター
見出し・主体・背景要素の位置をすべてボックスで制約できます。広告レイアウトやポスター組版に。
Poster: product bottle center, headline text box top-left, lifestyle scene bottom — each element in its own bounding box.
複数ラウンドの部分リファイン
ボックスごとに修正し、周辺はピクセル保持。繰り返し確認が必要な仕上げ工程に向きます。
Edit only the bounding box around the logo: replace with the new wordmark, keep everything else pixel-identical.
複数参照のシーン合成
人物・製品・背景などを複数の参照から、ボックスで構成した 1 枚に融合します。
Combine the model from image 1, the outfit from image 2, and the studio background from image 3 into one composition.
4K 印刷・大型出力
ネイティブ 4K（約 16.8MP）は拡大後も細部を保持。展示パネルや印刷素材に。
Trade-show backdrop at 4K: brand hero center, product lineup along the bottom edge, clean gradient background.
利用前に知っておくべき制限
- リクエスト単位の課金で、4K 段階（$0.607）は低段階より大幅に高額です。量産ドラフトは 768sq か 1K を推奨します。
- バウンディングボックスは 0〜1000 の正規化座標をプロンプト末尾に記述します。構文ミスは通常テキスト扱いまたはリクエスト検証で拒否されます。
- Roko の safety_tolerance は現在 0〜4（0 が最も厳しく、4 が最も寛容）で、既定は 2 です。上げる前に適用条項をご確認ください。
- 非同期タスクの送信成功は生成成功を意味しません。タスク照会の結果を基準にし、出力は使用前に人手で確認してください。
FLUX 3 Image と他の画像モデルの選び方
正確なレイアウトとボックス単位編集には FLUX 3。中国語圏のシーンやセット生成には Seedream シリーズ。透明背景や日常コンテンツには GPT Image 2.5。制御粒度・解像度・価格で選択してください。
すべてのモデル →FLUX 3 Image よくある質問
FLUX 3 Image API のモデル ID は？
Roko API の公開モデル ID は flux-3-image です。model フィールドにそのまま指定してください。
FLUX 3 Image API の料金は？
選択した解像度でリクエスト単位に課金：768sq $0.041、1K $0.048、1.5K $0.07、2K $0.10、4K $0.607。確認時は BFL の定価と同額でしたが、Roko の請求は送信時のプロジェクト見積りと最終決済が基準です。
バウンディングボックスレイアウトの使い方は？
公式方式は、キャンバスを 0〜1000 に正規化し、プロンプト末尾に要素ごとのボックスと説明を書きます（例：「fountain (400,500)-(600,800)」）。生成結果はこれらの位置制約を満たします。
ボックス単位編集とは？
完成画像をボックスごとに修正する方式です。ボックス内だけが再描画され、外側はピクセルレベルで保持されます。複数ラウンドで反復でき、画像全体のドリフトを防げます。
対応する解像度とアスペクト比は？
Roko では現在 768sq・1K・1.5K・2K・4K の 5 段階と 16 種類のアスペクト比（既定 auto）を公開しています。4K は約 16.8 メガピクセルのネイティブ出力で、アップスケールではありません。
どのエンドポイントで呼び出しますか？
POST /v1/images/tasks で非同期タスクを送信して task_id を取得し、GET /v1/tasks/{task_id} で結果または失敗理由をポーリングします。
grounding パラメータの役割は？
grounding を有効にすると、モデルがウェブ検索でプロンプト情報（リアルタイムの事実やブランド素材の説明など）を補完します。既定はオンで、不要なら明示的にオフにできます。
オープンウェイトは使えますか？
最新確認時点（2026-10-06）では、BFL はオープンウェイトを「数週間以内」に公開するとしており、商用ウェイトは別途ライセンスが必要です。Roko では BFL の公式 API チャネルを利用します。