FLUX 3 Image Klein APIドキュメント
コードからFLUX 3 Image Kleinを呼び出すために必要な情報をすべて掲載しています。ベースURLはhttps://cheapergen.com/api/v1です。まずプレイグラウンドでお試しください。
コーディングエージェントを使いますか?
これをClaude Code、Cursor、Codex、または任意のコーディングエージェントに貼り付けてください。プロジェクトにAPIを追加し、キーをCHEAPERGEN_API_KEYに保存して、支払いが発生する前に無料見積もりでテストします。
Add FLUX 3 Image Klein (CheaperGen endpoint bfl/ flux-3-image-klein/ 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 3 Image Klein テキストから画像を生成 API
/api/v1/run/bfl/flux-3-image-klein/text-to-image非同期ジョブを送信すると、生成IDを含む202が返されます。GET /api/v1/generations/{id}をポーリングするか、webhook_urlを指定してください。詳細はジョブのライフサイクルをご覧ください。
入力パラメーター
| 名前 | 種類 | 説明 | 料金に影響 |
|---|---|---|---|
prompt必須 | string | ショットを説明してください:被写体、動き、カメラワーク、照明、スタイル。 | いいえ |
aspect_ratio | string (enum) | 出力画像の形状。 値:1:1 · 4:5 · 3:4 · 2:3 · 9:16 · 1:2 · 9:21 · 5:4 · 4:3 · 3:2 · 16:9 · 2:1 · 21:9 · 7:5 · 5:7 デフォルト:1:1 | はい |
resolution | string (enum) | 出力サイズ:768 ≈ 0.6 MP、1K ≈ 1 MP、1.5K ≈ 2.4 MP、2K ≈ 4 MP、4K ≈ 16 MP。2Kまでは横長・縦長比率でも長辺を2048 px以下に保ちます。4Kでは1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16, 21:9, 9:21になります。 値:768 · 1K · 1.5K · 2K · 4K デフォルト:1K | はい |
seed | integer | 同じ結果を再現するには、seedと設定を同じにしてください。ランダムにする場合は空欄のままにします。 | いいえ |
enable_safety_checker | boolean | trueに設定すると、安全性チェッカーが有効になります。どちらの設定でも、当社の利用規定で禁止されているコンテンツはブロックされます。 デフォルト:true | いいえ |
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-3-image-klein/text-to-image`, {
method: "POST",
headers,
body: JSON.stringify({
"prompt": "手びねりのテラコッタ花瓶に、乾燥したオレンジ色のラナンキュラスを飾ったエディトリアルな静物写真。トラバーチンの台座、左から差す低いゴールデンアワーの光、漆喰壁に伸びる柔らかな影、中判フィルム写真。",
"aspect_ratio": "1:1",
"resolution": "1K"
}),
}).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-3-image-klein",
"endpoint": "bfl/flux-3-image-klein/text-to-image",
"mode": "text-to-image",
"status": "queued",
"input": {
"prompt": "手びねりのテラコッタ花瓶に、乾燥したオレンジ色のラナンキュラスを飾ったエディトリアルな静物写真。トラバーチンの台座、左から差す低いゴールデンアワーの光、漆喰壁に伸びる柔らかな影、中判フィルム写真。",
"aspect_ratio": "1:1",
"resolution": "1K"
},
"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"
}FLUX 3 Image Klein 画像を編集 API
/api/v1/run/bfl/flux-3-image-klein/edit非同期ジョブを送信すると、生成IDを含む202が返されます。GET /api/v1/generations/{id}をポーリングするか、webhook_urlを指定してください。詳細はジョブのライフサイクルをご覧ください。
入力パラメーター
| 名前 | 種類 | 説明 | 料金に影響 |
|---|---|---|---|
prompt必須 | string | ショットを説明してください:被写体、動き、カメラワーク、照明、スタイル。 | いいえ |
image_urls必須 | string[] (URLs) | 編集・合成に使える参照画像は最大10枚です。プロンプトでは「画像1」「画像2」…と指定してください。 最大項目数:10 | いいえ |
aspect_ratio | string (enum) | 出力画像の形状。 値:auto · 1:1 · 4:3 · 3:4 · 3:2 · 2:3 · 16:9 · 9:16 · 21:9 · 9:21 デフォルト:auto | はい |
resolution | string (enum) | 出力サイズ:1K ≈ 1 MP、2K ≈ 4 MP、4K ≈ 16 MP。 値:1K · 2K · 4K デフォルト:1K | はい |
seed | integer | 同じ結果を再現するには、seedと設定を同じにしてください。ランダムにする場合は空欄のままにします。 | いいえ |
enable_safety_checker | boolean | trueに設定すると、安全性チェッカーが有効になります。どちらの設定でも、当社の利用規定で禁止されているコンテンツはブロックされます。 デフォルト:true | いいえ |
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-3-image-klein/edit`, {
method: "POST",
headers,
body: JSON.stringify({
"prompt": "画像2のランプを画像1の机に置き、部屋、光、カメラの角度はそのままにしてください。",
"image_urls": [
"https://cdn.cheapergen.com/samples/portrait.jpg"
],
"aspect_ratio": "auto",
"resolution": "1K"
}),
}).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-3-image-klein",
"endpoint": "bfl/flux-3-image-klein/edit",
"mode": "edit",
"status": "queued",
"input": {
"prompt": "画像2のランプを画像1の机に置き、部屋、光、カメラの角度はそのままにしてください。",
"image_urls": [
"https://cdn.cheapergen.com/samples/portrait.jpg"
],
"aspect_ratio": "auto",
"resolution": "1K"
},
"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 3 Image Kleinの料金
従量課金: 画像1枚あたりを使った分だけ支払えます。サブスクリプションは不要です。生成に失敗した場合は自動で返金されます。
| プラン | 公式価格 | CheaperGen | 節約額 |
|---|---|---|---|
768 768×768 | $0.0011/img 月額プランの場合: Max $0.001 | −87% | |
1K 1024×1024 | $0.0019/img 月額プランの場合: Pro $0.0018Max $0.0017 | −79% | |
1.5K 1536×1536 | $0.0043/img 月額プランの場合: Pro $0.004Max $0.0038 | −61% | |
2K 2048×2048 | $0.0074/img 月額プランの場合: Pro $0.0069Max $0.0065 | −48% | |
4K 約16 MP | $0.0342/img | −5% | |
1Kを編集 参照画像1〜10枚 | $0.0085/img | −6% | |
2Kを編集 参照画像1〜10枚 | $0.0133/img | −5% | |
4Kを編集 参照画像1〜10枚 | $0.0342/img | −5% |
月額プラン多くのモデルが割引価格になります(各モデルの料金の下に表示)。従量課金も引き続き利用できます。Pro $499/月 · Max $4,999/月。
- 公式価格:BFL APIの公式価格:FLUX 3 Image Klein(768²で$0.008、1Kで$0.009、1.5Kで$0.011、2Kで$0.014、4Kで$0.036。編集も同額) — https://docs.bfl.ai/quick_start/pricing#flux-3-image-klein。価格確認日:2026年10月18日。
- 編集には出力サイズ(Edit行:1K、2K、4K)ごとの料金が適用されます。参照画像は最大10枚まで、枚数にかかわらず同じ料金です。
- BFLのプロンプト拡張を使わずに配信します。プロンプトは入力どおりにモデルへ渡されます。