Roko API
コンソール
テキストから画像生成 · 参照画像編集 · 最大 4K ● 利用可能

FLUX 3 Image API

Roko API の flux-3-image は Kie AI 経由の FLUX 3 Klein です。参照画像なしなら画像生成、画像を渡すと自動的に編集へ切り替わります。1K・2K・4K、1 回あたり 1〜4 枚に対応します。

API key を取得 API ドキュメント全文を見る
公開モデル ID
flux-3-image
出力段階
1K / 2K / 4K（既定 1K）
課金方式
生成枚数 × 選択解像度
エンドポイント
POST /v1/images/tasks
カタログスナップショット

FLUX 3 Image とは？

公開 ID flux-3-image は現在、Kie AI 経由で FLUX 3 Klein を提供します。BFL の FLUX 3 Image 完全版 API の全機能を公開するものではありません。

同じモデル ID を使い、参照画像なしで新規生成、公開画像 URL を 1〜10 枚渡すと編集へ自動的に切り替わります。

解像度は 1K・2K・4K、出力は 1 回 1〜4 枚です。非同期タスクを送信して結果を取得し、選択した解像度と実際に成功した出力枚数で精算します。

主な能力

テキストから画像生成

被写体、背景、スタイルを記述します。上流モデルの切り替えは不要です。

参照画像の編集

1〜10 枚の参照画像と変更・維持したい内容を指定し、結果を確認してください。

複数枚の出力

n は 1〜4。実際に成功した出力枚数で精算します。

3 段階の解像度

対応するアスペクト比で 1K・2K・4K を選択できます。

FLUX 3 Image API の料金

料金は現在の Roko カタログから生成され、選択した解像度で生成画像単位に課金されます。検証時は Kie AI の通常価格と同額でしたが、上流の価格やキャンペーンは Roko の請求を決めません。送信時の Roko 見積りと最終決済をご確認ください。

解像度料金課金単位
1k$0.011 枚あたり
2k$0.0161 枚あたり
4k$0.0361 枚あたり

費用例

1K 画像 1 枚1 × $0.008 = $0.008

既定段階。ウェブ・SNS 素材の標準コストです。

4K 出力を 1 枚1 × $0.0325 = $0.0325

実際に成功した出力枚数で精算します。現在の価格による計算例です。

パラメータと対応範囲

現在の Kie 接続設定に基づく項目です。参照画像は公開 HTTP / HTTPS URL のみです。専用の境界ボックス配置、grounding、safety_tolerance は公開していません。

パラメータ値説明
prompttextarea生成したい画像や、参照画像への変更内容を記述します。 · 必須
imagesurl · 1–10公開 HTTP / HTTPS 画像 URL を最大 10 枚指定します。Base64 やブラウザーの blob: URL は使えません。 · 任意
aspect_ratioauto / 1:1 / 16:9 / 9:16 / 4:3 / 3:4 / 3:2 / 2:3 / 21:9 / 9:21編集の auto は参照画像に合わせます。テキスト生成では省略または auto で 1:1 を使用します。 · デフォルト: auto · 任意
resolution1k / 2k / 4kこのモデルで設定された出力解像度を選択します。値によって料金が変わる場合があります。 · デフォルト: 1k · 任意
n1–41 リクエストで生成する画像枚数。多いほど費用が上がります。 · デフォルト: 1 · 任意
output_formatpng / jpeg / webp生成画像のファイル形式。png または jpeg を選択します。 · デフォルト: png · 任意
enhance_promptboolean任意
seedinteger任意

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": "A ceramic mug on a white studio background, soft side lighting.",
  "aspect_ratio": "16:9",
  "resolution": "2k"
}'

復元タスクを照会

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 は一意である必要があり、同じキーの再送は元のタスクを返し、重複課金されません。

適したシーン

商品シーンの下書き

商品、照明、背景を記述し、まず 1K で構図を確認します。

A ceramic mug on a white studio background, soft side lighting.

背景や色の変更

参照画像と変更内容を指定します。他の画素がすべて保持されるとは限りません。

Change the mug to blue while keeping its shape and the white background.

複数の参照画像の組み合わせ

各画像が提供する被写体、スタイル、背景を説明します。

Use the product from image 1 and the background from image 2.

複数案の検討

n で最大 4 枚を生成し、確認して選択します。

Create alternative studio compositions of a ceramic mug.

利用前に知っておくべき制限

  • 参照画像は公開 HTTP / HTTPS URL を 1〜10 枚指定します。Base64、Data URL、blob: URL は使えません。
  • 固定アスペクト比は 9 種類です。編集は auto に対応し、テキスト生成で省略または auto を指定すると 1:1 になります。
  • Klein 接続では編集箇所以外の画素の完全保持を保証せず、完全版の専用レイアウト制御やウェブ検索パラメータも公開していません。
  • 送信成功は受付を意味します。最終状態まで照会し、利用前に画像を確認してください。

FLUX 3 Image と他の画像モデルの選び方

用途、参照画像の制限、解像度、現在の価格を基準に選択してください。同条件での品質・速度比較は行っていません。

すべてのモデル →

FLUX 3 Image よくある質問

FLUX 3 Image API のモデル ID は？

Roko API の公開モデル ID は flux-3-image です。model フィールドにそのまま指定してください。

FLUX 3 Image API の料金は？

選択した解像度で生成画像単位に課金：1K $0.008、2K $0.0125、4K $0.0325。確認時は Kie AI の通常価格と同額でしたが、Roko の請求は送信時のプロジェクト見積りと最終決済が基準です。

生成と編集でモデル ID を変える必要がありますか？

不要です。flux-3-image のまま、参照画像なしで生成、画像ありで自動的に編集へ切り替わります。

参照画像はどう送りますか？

image_urls または images に公開 HTTP / HTTPS URL を 1〜10 枚指定します。image、input_reference も使えます。

対応する解像度とアスペクト比は？

1K・2K・4K と、1:1、16:9、9:16、4:3、3:4、3:2、2:3、21:9、9:21 に対応します。編集は auto、テキスト生成の auto は 1:1 です。

どのエンドポイントで呼び出しますか？

POST /v1/images/tasks で非同期タスクを送信して task_id を取得し、GET /v1/tasks/{task_id} で結果または失敗理由をポーリングします。

BFL の完全版 API ですか？

Kie AI 経由の FLUX 3 Klein です。専用の境界ボックス配置やウェブ検索パラメータを公開せず、完全版の機能をそのまま推定できません。

1 回に何枚生成できますか？

n は 1〜4、既定値は 1 です。選択した解像度と実際に成功した出力枚数で精算します。