はじめに
FLUX.2 [flex] テキストから画像 は、2025 年 11 月 25 日に公開された、文字とレイアウトのための Black Forest Labs の FLUX.2 モデルです。文章のプロンプトを画像に変え、引用した文字を綴りどおりに書き込み、16 進のカラーコードに従い、1k または 2k、9 種類の形で描画します。
手元の素材でモードを選ぶ
| 手元にあるもの | モード |
|---|---|
| 文章の指示 | FLUX.2 [flex] テキストから画像 |
| 変更または組み合わせたい画像 | FLUX.2 [flex] 編集 |
主な機能とハイライト
書いたとおりに返る文字
私たちのテストでは、タイトル、タグライン、公開日の行がある映画のポスター、筆記体のタイトルのアルバム表紙、紅茶缶のラベルのいずれも、引用した行がすべて正しい綴りで返りました。
16 進コードでの色指定
大きな物体、背景、色調の隣にコードを書くと、描画はそれに近づきます。ごく小さな文字では、色味がずれることがあります。
2 つのサイズ段階と 9 種類の形
1k は約 100 万画素、2k は長辺 2048 ピクセルで描画し、21:9 のバナーから 9:21 のストーリーまで選べます。2k は 1k より高く、形が料金を変えることはありません。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
prompt | はい | 最大 5,000 文字。被写体、場所、光、スタイルを平易な文章で書きます。 1 文字以上 · 5000 文字以内 |
aspect_ratio | いいえ | 21:9 から 9:21 までの 9 種類から 1 つを選びます。既定は 1:1 です。 |
resolution | いいえ | 1k(既定)は約 100 万画素、2k は長辺 2048 ピクセルで描画します。2k は 1k より高くなります。 |
seed | いいえ | 0〜2147483647 の整数(任意)。同じプロンプトで再利用すると、バリエーションを並べて比べられます。 |
料金
サイズ段階ごとの 1 枚単位の課金です。2k は 1k より高く、比率は料金に影響しません。拒否または失敗したリクエストは課金されません。
| 仕様 | 料金 |
|---|---|
| $0.0578 / 枚 |
| $0.0881 / 枚 |
ユースケース
ポスターと表紙
文字がデザインの一部になる、映画のポスター、アルバムの表紙、雑誌の誌名。
パッケージと商品写真
決まったブランドカラーのラベル、缶、ボトルを、スタイリングした場面で撮影した写真。
広告の見出し
光を当てたシーンに見出しと 1 行のコピーを置き、プレゼンや最初のレイアウトにそのまま使えます。
プロンプトガイドと実践のヒント
すべての行を引用して位置を示す
各行の文字を引用符で囲み、置く場所を書きます。最後に "No other text" を添えると、余計な言葉が現れるのを防げます。
色はコードで
物体と 16 進値をセットで書きます。たとえば、クリーム色 #F3E9D2 のラベルと、金色 #C9A227 の縁取りのように書きます。
人物は服装とポーズで描く
各人物の服装、立ち位置、視線の向きを書いてください。軽めのレベルのポートレートは描かれ、それより強いリクエストは拒否されるか、和らげられます。
文字なら 2k から
大きなサイズでは小さな文字にピクセルが多く割り当てられ、読みやすくなります。手早い下書きには 1k をお使いください。
20〜90 秒を見込む
テストでは、ほとんどのリクエストがこの範囲で完了しました。キューが混み合っているとさらにかかります。
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-flex/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 リファレンスを参照してください。

























