FLUX.2 [flex] APIドキュメント
コードからFLUX.2 [flex]を呼び出すために必要な情報をすべて掲載しています。ベースURLはhttps://cheapergen.com/api/v1です。まずプレイグラウンドでお試しください。
コーディングエージェントを使いますか?
これをClaude Code、Cursor、Codex、または任意のコーディングエージェントに貼り付けてください。プロジェクトにAPIを追加し、キーをCHEAPERGEN_API_KEYに保存して、支払いが発生する前に無料見積もりでテストします。
Add FLUX.2 [flex] (CheaperGen endpoint bfl/ flux-2-flex/ text-to-image) to this project by following https:/ / cheapergen.com/ agents/ integrate.md認証
ダッシュボード → APIキーでキーを作成し、Bearerトークンとして送信してください。キーはサーバー側で管理してください。
export CHEAPERGEN_API_KEY="cg_live_…"
# every request
Authorization: Bearer $CHEAPERGEN_API_KEYFLUX.2 [flex] テキストから画像を生成 API
POST
/api/v1/run/bfl/flux-2-flex/text-to-image非同期ジョブを送信すると、生成IDを含む202が返されます。GET /api/v1/generations/{id}をポーリングするか、webhook_urlを指定してください。詳細はジョブのライフサイクルをご覧ください。
入力パラメーター
| 名前 | 種類 | 説明 | 料金に影響 |
|---|---|---|---|
prompt必須 | string | ショットを説明してください:被写体、動き、カメラワーク、照明、スタイル。 | いいえ |
aspect_ratio | string (enum) | 出力画像の形状。 値:1:1 · 4:3 · 3:4 · 16:9 · 9:16 · 3:2 · 2:3 · 21:9 · 9:21 デフォルト:1:1 | はい |
resolution | string (enum) | 出力サイズ(メガピクセル)。1 MPは約1024×1024ピクセルです。FLUX.2はメガピクセル単位で課金されます。 値:1MP · 2MP · 3MP · 4MP デフォルト:1MP | はい |
steps | integer | サンプリングステップ数。増やすと細部が増えて時間もかかります(料金は同じ)。 範囲:1~50 デフォルト:50 | いいえ |
guidance | integer | 画像がプロンプトにどれだけ忠実に従うか(1.5〜10)。 範囲:1.5~10 デフォルト:5 | いいえ |
prompt_upsampling | boolean | 生成前にモデルがプロンプトを補足・書き換えます。 デフォルト:false | いいえ |
seed | integer | 同じ結果を再現するには、seedと設定を同じにしてください。ランダムにする場合は空欄のままにします。 | いいえ |
webhook_url | string (URL) | 任意。生成が完了すると、Webhookシークレットで署名してここにPOSTします。Webhook | いいえ |
リクエスト
const API = "https://cheapergen.com/api/v1";
const headers = {
Authorization: `Bearer ${process.env.CHEAPERGEN_API_KEY}`,
"Content-Type": "application/json",
};
// 1. Submit the job
let job = await fetch(`${API}/run/bfl/flux-2-flex/text-to-image`, {
method: "POST",
headers,
body: JSON.stringify({
"prompt": "リネンのテーブルに置かれたドライフラワー入りの陶器の花瓶を撮影したエディトリアル写真。北側からの柔らかな光、フィルム粒子。",
"aspect_ratio": "1:1",
"resolution": "1MP"
}),
}).then((r) => r.json());
// 2. Poll until it finishes (or pass webhook_url and skip polling)
while (job.status === "queued" || job.status === "running") {
await new Promise((r) => setTimeout(r, 3000));
job = await fetch(`${API}/generations/${job.id}`, { headers }).then((r) => r.json());
}
console.log(job.status === "succeeded" ? job.output.images[0].url : job.error);レスポンス
{
"id": "gen_8c2QmX1nq0k4",
"object": "generation",
"model": "bfl/flux-2-flex",
"endpoint": "bfl/flux-2-flex/text-to-image",
"mode": "text-to-image",
"status": "queued",
"input": {
"prompt": "リネンのテーブルに置かれたドライフラワー入りの陶器の花瓶を撮影したエディトリアル写真。北側からの柔らかな光、フィルム粒子。",
"aspect_ratio": "1:1",
"resolution": "1MP"
},
"output": null,
"error": null,
"cost": {
"amount_usd": 0.2255,
"currency": "usd",
"estimated": true,
"official_usd": null,
"list_price_source": "official",
"list_price_label": "Official",
"saved_usd": null
},
"source": "api",
"started_at": null,
"completed_at": null,
"urls": {
"get": "https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4",
"cancel": "https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4/cancel"
},
"created_at": "2026-10-15T09:21:04Z"
}結果を取得する
生成処理は非同期です。statusがsucceeded、failed、またはcanceledになるまでポーリングしてください。送信時にwebhook_urlを指定する方法もあります。失敗した生成は自動返金されます。
curl https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4 \
-H "Authorization: Bearer $CHEAPERGEN_API_KEY"その他:ジョブのライフサイクル · Webhook · エラー
FLUX.2 [flex]の料金
従量課金: 画像1枚あたりを使った分だけ支払えます。サブスクリプションは不要です。生成に失敗した場合は自動で返金されます。
| プラン | 公式価格 | CheaperGen | 節約額 |
|---|---|---|---|
1 MP ≈1024×1024 | $0.046/img | −8% | |
2 MP | $0.0861/img 月額プランの場合: Pro $0.0841Max $0.0821 | −14% | |
3 MP | $0.115/img 月額プランの場合: Pro $0.1101Max $0.1052 | −23% | |
4 MP ≈2048×2048 | $0.1364/img 月額プランの場合: Pro $0.1294Max $0.1223 | −32% |
月額プラン多くのモデルが割引価格になります(各モデルの料金の下に表示)。従量課金も引き続き利用できます。Pro $499/月 · Max $4,999/月。
- 公式価格:FLUX.2 [flex]のBFL API公開価格(出力・入力画像ともに1メガピクセルあたり$0.05)。価格確認日:2026年10月18日。
- テキストから画像への生成のみ。編集にはFLUX.2 [pro]、FLUX 3、Kontextをお使いください。