はじめに
FLUX.2 [klein] 4B テキストから画像は、Apache 2.0 のオープンソースである Black Forest Labs の最小の FLUX.2 モデルで、文章のプロンプトから画像を 1 枚生成します。9 種類のアスペクト比から選び、約 100 万画素(1k)、または長辺 2048 ピクセルまで(2k)の JPEG が、およそ 15〜35 秒で返ります。プロンプトにも結果にも、コンテンツフィルターはかかりません。
手元にあるものでモードを選ぶ
| 手元にあるもの | モード |
|---|---|
| 文章の説明 | FLUX.2 Klein 4B テキストから画像 |
| 変更または合成したい 1〜3 枚の画像 | FLUX.2 Klein 4B 画像編集 |
主な機能とハイライト
小さくて速い
40 億パラメーターで、FLUX.2 モデルの中で最も軽量です。下書きやモックアップ、アイデアを続けて数多く試すのに向いています。
引用符つきの文字と 16 進カラー
引用符で囲んだ短い見出しと、16 進カラーコードを理解します。結果はそれなりですが、保証はありません。綴りを間違えたり、色が意図と違うものに乗ったりすることがあります。
オープンで、フィルターなし
何も審査されず、拒否もされません。限界はモデル自体にあります。モデルは自分から衣服を足しがちで、かなり強めのレベルは描画されません。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
prompt | はい | 被写体、服装、場所、光を文章で書き、最大 5,000 文字です。看板やポスターの文字は引用符で囲み、色は 16 進コードで書いてください。 1 文字以上 · 5000 文字以内 |
aspect_ratio | いいえ | 21:9 から 9:21 までの 9 種類から選び、既定は 1:1 です。比率で料金は変わりません。 |
resolution | いいえ | サイズの段階です。1k は約 100 万画素(既定)、2k は長辺 2048 ピクセルです。 |
seed | いいえ | 0〜2147483647 の数値です。細部を 1 つだけ変えて結果を比べるときに再利用します。 |
料金
1 枚ごとの課金です。選んだサイズの段階は、実行前に表示される料金に反映され、アスペクト比で料金は変わりません。失敗したリクエストには課金されません。
| 仕様 | 料金 |
|---|---|
| $0.0093 / 枚 |
| $0.0099 / 枚 |
ユースケース
本番の前の下書き
十数個のプロンプトと seed を素早く試し、細部がもっと必要なら、最良のアイデアを大型モデルに持っていきます。
ポスターとネオンの場面
イベントのポスター、広告のモックアップ、看板や色つきの光のある夜の場面は、このモデルの範囲で十分に働きます。
雰囲気のあるポートレート
光源が 1 つの単独の被写体は、とくに手が隠れているかフレーム外にあると、きれいに出ます。
プロンプトガイドと実践のヒント
服装は自分で書く
このモデルは自分で服を加えます。それぞれの人物が何を着ているかを 1 点ずつ正確に書けば、その指定に従います。
文字は引用符で囲み、短くする
引用符つきの短い言葉 1〜2 語が最も確実です。文字が崩れたら、seed だけを変えてもう一度実行します。
二人を写すときは手の描写を単純に
2 人を入れると、最初に崩れるのは手です。肩、手すり、グローブに置くか、seed を複数回試して最良のものを選びます。
API クイックスタート
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "black-forest-labs/flux-2-klein-4b/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "1k",
"aspect_ratio": "1:1"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
認証、完全なスキーマ、ポーリング、エラー処理は API リファレンスを参照してください。

























