Flux 2 Flex API
ステップ数とガイダンスを調整できる Flux 2。
Flux 2 Flex を1回のAPIコールで統合できます。1つのキー、1つの統一エンドポイント、そしてApiframe上のすべてのモデルで共通の請求。
model: "flux-2-flex"
Flux 2 Flex の特長
- 0.5MP / 1MP / 2MP / 4MP で出力。
- 1:1, 3:4, 4:3 を含む 5 種類のアスペクト比に対応。
- 画像から画像への編集と参照画像に対応。
- 高速処理 — 1回の生成あたり平均約15秒。
- Black Forest Labs のアカウント不要の従量課金。成功した生成分だけお支払いいただきます。
- Apiframe のすべてのモデルで、1つのAPIキー・統一請求・冪等性・Webhookに対応。
Flux 2 Flex で作成
Apiframeの Flux 2 Flex API で生成した出力例です。
A clean infographic titled 'How Solar Panels Work' with four labeled steps, flat modern style.
A mobile app dashboard with a balance card reading '$2,480.00', three menu tabs, and legible button labels.
A minimalist logo for a bakery called 'FLOUR & STONE', clean serif lettering, warm neutral palette.
A concert poster reading 'NIGHT MARKET LIVE' with the date 'AUG 14' and venue, bold typographic layout.
A kombucha bottle label reading 'WILD GINGER' with 'Organic, 330ml' beneath, crisp small text.
A square promo reading '24-HOUR FLASH SALE, UP TO 50% OFF' with clean type and a bright gradient.
概要
- エンドポイント
- POST /v2/images/generate
- モデルID
- flux-2-flex
- パラメータキー
- fluxParams
- モダリティ
- 画像
- プロバイダー
- Black Forest Labs
- 平均完了時間
- ~15s
機能
クイックスタート
APIキーを添えて POST /v2/images/generate に1回リクエストを送るだけで Flux 2 Flex による生成が始まります。レスポンスには、ポーリングまたはWebhookで受け取れる jobId が返ります。
curl -X POST https://api.apiframe.ai/v2/images/generate \
-H "X-API-Key: afk_your_api_key_here" \
-H "Content-Type: application/json" \
-d '{
"prompt": "a sleek silver sports car on a coastal highway at sunset, hyper-realistic",
"model": "flux-2-flex",
"fluxParams": {
"resolution": "2MP",
"image_prompt": "https://example.com/input.jpg",
"image_prompt_strength": 0.5,
"steps": 28
}
}'import requests
response = requests.post(
"https://api.apiframe.ai/v2/images/generate",
headers={
"X-API-Key": "afk_your_api_key_here",
"Content-Type": "application/json",
},
json={
"prompt": "a sleek silver sports car on a coastal highway at sunset, hyper-realistic",
"model": "flux-2-flex",
"fluxParams": {
"resolution": "2MP",
"image_prompt": "https://example.com/input.jpg",
"image_prompt_strength": 0.5,
"steps": 28
}
},
)
print(response.json()) # { "jobId": "...", "status": "QUEUED" }const response = await fetch("https://api.apiframe.ai/v2/images/generate", {
method: "POST",
headers: {
"X-API-Key": "afk_your_api_key_here",
"Content-Type": "application/json",
},
body: JSON.stringify({
"prompt": "a sleek silver sports car on a coastal highway at sunset, hyper-realistic",
"model": "flux-2-flex",
"fluxParams": {
"resolution": "2MP",
"image_prompt": "https://example.com/input.jpg",
"image_prompt_strength": 0.5,
"steps": 28
}
}),
});
const { jobId } = await response.json();
console.log(jobId);レスポンスとジョブのライフサイクル
生成は非同期で行われます。送信が成功すると 202 Accepted と jobId が返ります。ステータスが COMPLETED になるまで GET /v2/jobs/{id} をポーリングする(または webhook_url を指定する)と、result フィールドに出力URLが格納されます。
1. 送信レスポンス (202)
{
"jobId": "b2c3d4e5-f6a7-8901-bcde-f23456789012",
"status": "QUEUED"
}2. 結果をポーリング
curl https://api.apiframe.ai/v2/jobs/JOB_ID \
-H "X-API-Key: afk_your_api_key_here"import requests, time
while True:
job = requests.get(
"https://api.apiframe.ai/v2/jobs/JOB_ID",
headers={"X-API-Key": "afk_your_api_key_here"},
).json()
if job["status"] in ("COMPLETED", "FAILED"):
break
time.sleep(2)
print(job["result"])let job;
do {
await new Promise((r) => setTimeout(r, 2000));
job = await fetch("https://api.apiframe.ai/v2/jobs/JOB_ID", {
headers: { "X-API-Key": "afk_your_api_key_here" },
}).then((r) => r.json());
} while (job.status !== "COMPLETED" && job.status !== "FAILED");
console.log(job.result);入力スキーマ
Flux 2 Flex エンドポイントが受け付けるリクエストパラメータです。モデル固有のオプションは、下記のパラメータオブジェクトの中にネストされます。
| パラメータ | 型 | 必須 | デフォルト | 許可値 / 範囲 | 説明 |
|---|---|---|---|---|---|
| prompt | string | 必須 | — | — | 生成する内容のテキスト説明。 |
| model | string | 必須 | "flux-2-flex" | "flux-2-flex" | このエンドポイントのモデル識別子。 |
| fluxParams.resolution | string | 任意 | "2MP" | "0.5MP", "1MP", "2MP", "4MP" | Resolution |
| fluxParams.image_prompt | string (URL) | 任意 | — | — | Reference image (URL) |
| fluxParams.image_prompt_strength | number | 任意 | 0.5 | min 0, max 1, step 0.05 | How closely to follow the reference image (0–1). |
| fluxParams.steps | number | 任意 | 28 | min 1, max 50, step 1 | Steps |
| fluxParams.guidance | number | 任意 | 3 | min 1.5, max 10, step 0.1 | How strictly to follow the prompt. |
| fluxParams.output_format | string | 任意 | "jpg" | "jpg", "png", "webp" | Output format |
| fluxParams.output_quality | number | 任意 | 90 | min 0, max 100, step 1 | Output quality |
| fluxParams.prompt_upsampling | boolean | 任意 | false | — | Let the model rewrite your prompt for better quality. |
| fluxParams.go_fast | boolean | 任意 | false | — | Go fast |
| fluxParams.seed | number | 任意 | — | step 1 | Reuse a number to reproduce the same result. |
よくある質問
Flux 2 Flex APIに関するよくある質問をまとめました。
Flux 2 Flex の API はありますか?
はい。Apiframe は単一の REST エンドポイント(`POST /v2/images/generate`、`model: "flux-2-flex"`)で Flux 2 Flex を提供します。対応するすべてのモデルで、統一されたAPI・キー・請求をご利用いただけ、Black Forest Labs の個別アカウントは不要です。
Flux 2 Flex API の料金はいくらですか?
Flux 2 Flex は Apiframe のシンプルな従量課金制で、成功した生成分のみお支払いいただきます。プランと数量割引は料金ページをご覧ください。
Flux 2 Flex API はどのように呼び出しますか?
`X-API-Key` と、`model: "flux-2-flex"` を含む JSON ボディを添えて `/v2/images/generate` に POST リクエストを送ります。レスポンスで返る `jobId` を `GET /v2/jobs/{id}` でポーリングするか、Webhook で結果を受け取ります。
Flux 2 Flex はどんなパラメータに対応していますか?
Flux 2 Flex は、共通の `prompt`・`webhook_url` に加えて、`fluxParams` の下にネストされた 10 個のモデル固有パラメータを受け付けます。型やデフォルト値を含む一覧は上記の入力スキーマをご覧ください。
解決しませんでしたか?
Flux 2 Flex API で開発を始めよう
APIキーを取得すれば数分で Flux 2 Flex を統合できます — 従量課金。
ご質問はありますか? Discordに参加 または 営業に問い合わせる。