はじめに
FLUX.2 Dev テキストから画像は、Black Forest Labs が 2025 年 11 月 25 日に公開した 320 億パラメーターのオープンウェイトモデル FLUX.2 [dev] で、文章のプロンプトから画像を生成します。画像の中に読める文字を描き、16 進カラーコードに従い、1k では約 100 万画素、2k では長辺 2048 ピクセルまでを、9 種類のアスペクト比で返します。プロンプトにも結果にも、フィルターはかかりません。
手元にあるものでモードを選ぶ
| 手元にあるもの | モード |
|---|---|
| 文章の指示 | FLUX.2 Dev テキストから画像 |
| 変更または合成したい 1〜3 枚の画像 | FLUX.2 Dev 画像編集 |
主な機能とハイライト
綴りどおりに出る文字
当社のテストでは、看板、ネオン、ラベルの短い引用文字が正しく描かれました。店の扉の「CLOSED」の看板も、ネオンの「VACANCY」も、書いたとおりの綴りでした。
16 進カラーによる色の指定
描写する光や物の横に、#FF4F8B や #3AA7FF のようなコードを書きます。強いヒントとして働くので、ブランドカラーの厳密な再現よりも、雰囲気や照明に向いています。
フィルターなし、モデル自体の限界あり
何も審査されず、拒否もされません。当社のテストでは、軽め、中程度、強め、最大のレベルは毎回出力されましたが、かなり強めのレベルは和らげられて返ってきました。そのレベルに向いたモデルではありません。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
prompt | はい | 最大 5,000 文字。被写体、服装、場所、光、カメラの質感を文章で書いてください。 1 文字以上 · 5000 文字以内 |
aspect_ratio | いいえ | 21:9 から 9:21 までの 9 種類で、既定は 1:1 です。1k では約 100 万画素で、16:9 なら 1344 x 768 です。 |
resolution | いいえ | 1k(既定)は約 100 万画素、2k は長辺 2048 ピクセルです。どちらの段階も料金は同じです。 |
seed | いいえ | 0〜2,147,483,647 の整数です。プロンプトの一部だけを変えて比べたいときに固定すると、結果を見比べやすくなります。 |
料金
1 枚ごとの課金です。1k と 2k は同じ料金で、アスペクト比でも料金は変わりません。失敗したリクエストには課金されません。
| 仕様 | 料金 |
|---|---|
| $0.0116 / 枚 |
| $0.0116 / 枚 |
ユースケース
ポートレートとライフスタイルの静止画
自然な場所にいる 1〜2 人を、フィルム調の写真で。ムードボード、カバー、キャラクター資料に使えます。
看板、ポスター、ラベル
店のウィンドウ、ネオンサイン、パッケージ、ポスターなど、数語が読める必要がある場面です。
モデレーションのないプラットフォーム
利用者がプロンプトに対して審査なしを期待するサービス向けです。軽めから最大までのレベルは、かなり強めを除いて対象になります。
プロンプトガイドと実践のヒント
写真の撮影指示書のように書く
被写体、服装、場所、光、フィルムの質感を、文章で書きます。FLUX.2 は長いプロンプトによく従います。
言葉を引用符で囲み、看板の位置を決める
入れたい文字は引用符で囲み、置き場所を書いてください。数語にとどめましょう。長い段落には誤りが残ることがあります。
光とその色を書く
「warm #E9A23B tungsten lamps」や「pink neon washing the room in #FF4F8B」のように書くと、場面に明確な色の方向が生まれます。
仕上げは 2k で
アイデアは 1k で試し、気に入ったものを同じ seed で 2k にして見比べます。料金はどちらの段階でも同じです。
人物が何を着ているかを書く
特定の衣装が欲しい場合は、それを書いてください。当社のテストでは、モデルは衣装についてプロンプトに書かれた内容に従いました。
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-dev/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 リファレンスを参照してください。
























