FLUX.2 APIの使い方と料金まとめ！クレジット単価・画像編集コストまで解説

監修者_SD以外

監修者プロフィール

森下浩志

日本最大級のAI情報プラットフォーム「romptn ai」編集長。著書に「0からはじめるStable Diffusion」「0からはじめるStable Diffusion モデル・拡張機能集編」など、AmazonベストセラーのAI関連書籍を多数執筆。AIにおける情報の非対称性を解消するための社内研修や出張講義も行う。

FLUX.2 APIでできることと料金確認の前提

FLUX.2は、Black Forest Labsが提供する画像生成・画像編集向けのモデルファミリーです。この記事では、公式APIとPlaygroundを使う前に押さえたい料金、APIキーの準備、初回生成、画像編集時のコストをまとめます。

料金は変わる可能性があるため、ここでは執筆時点で確認した公式ドキュメントを前提にします。実際に使う直前は、BFLのpricing calculatorとAPIレスポンスに返るcostを確認してください。この記事の目的は、細かな全価格を暗記することではなく、「どの条件で費用が増えるか」を判断できる状態にすることです。

FLUX.2の料金体系：クレジットとメガピクセル課金

FLUX.2の公式APIは、クレジット制とメガピクセル課金を組み合わせて考えると理解しやすくなります。公式ドキュメントでは、1 credit = $0.01 USD、APIとPlaygroundは同じ価格体系と説明されています。

1024×1024pxはおおよそ1MPです。出力サイズを上げるほど課金対象のMPが増え、編集では入力画像や参照画像の扱いも費用感に影響します。

表は目安です。特に編集系は公式ページ間で表記が揺れることがあるため、最終判断はcalculatorで確認しましょう。

モデル別の単価と用途の目安

最初に迷ったら、用途で選ぶのが安全です。低コストで何度も試したいなら一番軽いklein、記事や業務で使う完成画像を安定して作りたいならpro、文字や細部の制御を重視するならflex、品質とgrounding searchを重視するならmaxが候補になります。

ただし、最初からmaxで大量に試す必要はありません。プロンプトや構図を固める段階ではkleinや低解像度で試し、仕上げだけpro/maxに上げる方が費用を読みやすくなります。再現性が必要なワークフローではpreview endpointではなく固定endpointを選ぶ、という考え方も押さえておきましょう。

画像編集・参照画像でコストが増えるポイント

FLUX.2はテキストから画像を作るだけでなく、既存画像をもとに編集する使い方にも対応しています。編集では、出力解像度だけでなく、入力画像や参照画像の扱いも予算に関わります。

公式ドキュメントでは、multi-reference編集はAPIで最大8枚、Playgroundで最大10枚の参照に対応すると説明されています。商品写真、人物の一貫性、背景差し替えのように参照画像を増やすほど便利になりますが、試行回数も増えがちです。最初は1枚の参照と低めの解像度で結果の傾向を見て、必要な時だけ参照数や出力サイズを上げると失敗コストを抑えられます。

FLUX.2 APIの始め方：アカウント作成から初回生成まで

公式APIを使う流れはシンプルです。まずBFLのdashboardでアカウントを作成し、利用する組織とプロジェクトを確認します。次にクレジットを追加し、プロジェクト内でAPIキーを発行します。

初回は、いきなり高解像度や複数参照の編集に進むより、1024×1024px程度のテキスト生成で動作確認するのがおすすめです。APIが返すidとpolling_urlを見て、生成完了後に画像URLを取得できることを確認しましょう。ここまでできれば、Playgroundで作ったpromptをAPIへ移す準備が整います。

APIキーとBFL_API_KEYを準備する

APIキーは発行時にしか全体を確認できないため、作成したら安全な場所に保存します。フロントエンドのコードへ直接書くのではなく、サーバー側の環境変数として扱うのが基本です。

export BFL_API_KEY="your_api_key_here"

本番用とテスト用でプロジェクトやキーを分けておくと、利用量の確認や停止がしやすくなります。チームで使う場合も、誰がどの用途で使うキーなのか分かる名前を付けておくと後から管理しやすいです。

POSTしてpolling_urlで結果を受け取る流れ

FLUX.2 APIは、リクエストを投げたらすぐ画像が返る形ではなく、生成タスクを作ってから結果を取りに行く非同期形式です。最初のPOSTでidとpolling_urlを受け取り、そのpolling_urlを使ってReadyになるまで確認します。

まず、pro 系のエンドポイントに x-key ヘッダーを付け、prompt と width / height を載せて生成リクエストを POST します。curl なら次の 1 本です。

curl -X POST https://api.bfl.ai/v1/flux-2-pro-preview \
  -H "x-key: $BFL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt":"A clean product photo of a white sneaker","width":1024,"height":1024}'

返ってくるのは画像そのものではなく、タスクの id と polling_url です。この polling_url に x-key を付けて GET し、status が Ready になったら result.sample の画像 URL を取り出します。

# POST のレスポンス：画像ではなくタスク情報が返る
{ "id": "...", "polling_url": "https://...（このURLで結果を確認する）" }

# polling_url を x-key 付きで GET した結果
{ "status": "Ready", "result": { "sample": "https://...（署名付きURL・約10分で失効）" } }

Python でこの流れ（POST → ポーリング → 画像 URL 取得）をまとめると、そのまま動かせる最小コードはこうなります。

import os
import time
import requests

API_KEY = os.environ["BFL_API_KEY"]

# 1. 生成リクエストを作成（POST）
res = requests.post(
    "https://api.bfl.ai/v1/flux-2-pro-preview",
    headers={"x-key": API_KEY, "Content-Type": "application/json"},
    json={"prompt": "A clean product photo of a white sneaker", "width": 1024, "height": 1024},
).json()
polling_url = res["polling_url"]

# 2. polling_url を Ready になるまで確認（GET）
while True:
    time.sleep(1.5)
    result = requests.get(polling_url, headers={"x-key": API_KEY}).json()
    status = result["status"]
    if status == "Ready":
        print("画像URL:", result["result"]["sample"])  # 約10分で失効。すぐ保存する
        break
    if status in ("Error", "Failed"):
        print("生成失敗:", result)
        break

結果のsample URLは短時間で期限切れになります。サイトやアプリで使う画像は、生成後すぐにダウンロードして自分の保存先へ移しましょう。429は同時実行数、402はクレジット不足のサインです。

Playgroundで試してからAPI化する時の見方

非エンジニアの人や、まだpromptが固まっていない人は、先にPlaygroundで試すと失敗が少なくなります。公式ドキュメントではPlaygroundとAPIは同じ価格体系とされていますが、無料クレジットやキャンペーンの有無は時期やアカウントで変わります。固定の無料枠がある前提で予算を組まない方が安全です。

Playgroundで試す時は、モデル、解像度、参照画像の数をメモしておきましょう。API化した時に同じ条件で再現できるだけでなく、calculatorやcost fieldで費用を見直しやすくなります。

費用を抑えるための実用チェックリスト

費用を抑えるコツは、完成画像を作る前に小さく試すことです。

特に画像編集は、うまくいくまで試行回数が増えやすい領域です。最初に「何枚まで試すか」「どのモデルで仕上げるか」を決めておくと、想定外の消費を避けやすくなります。

商用利用・ローカル利用・ライセンスの注意点

BFLのHelp Centerでは、公式API経由の利用には追加の商用ライセンスは不要と説明されています。つまり、APIで画像を生成して使う場合と、モデル重みを自分でホストする場合は分けて考える必要があります。

open weightsやローカル実行では、モデルごとに条件が異なります。たとえばFLUX.2 [klein] 4BはApache 2.0として案内されていますが、[klein] 9Bや[dev]は非商用ライセンスの扱いです。業務利用でローカル運用や自社ホストを考える場合は、料金だけでなくライセンス条件も必ず確認しましょう。

FLUX.2 APIのよくある質問