はじめに
FLUX.2 [pro] テキストから画像 は、2025 年 11 月 25 日に公開された Black Forest Labs の FLUX.2 世代の実務向けモデルです。文章のプロンプトを、1k または 2k、9 種類の比率の写真のような画像に変え、画像内の文字を正しく読める形で描き、16 進コードで色を指定できます。
手元の素材でモードを選ぶ
| 手元にあるもの | モード |
|---|---|
| 文章の指示 | FLUX.2 [pro] テキストから画像 |
| 変更または組み合わせたい画像 1〜3 枚 | FLUX.2 [pro] 編集 |
主な機能とハイライト
画像内の読みやすい文字
言葉を引用し、置く場所を書いてください。ポスターのテストでは、セリフ体の見出しと小さなサンセリフ体の 1 行が、どちらも書いたとおりに描かれました。
16 進コードでの色の指定
色を 16 進コードで書くと、パレットがそれに従います。ポスターではティールと銅色のトーンを使い、海と水平線の帯がその色になりました。
ドキュメンタリーのようなリアルさ
肌の質感、窓の光、フィルムグレインが写真のように見えます。バルコニーのポートレートは、2k でもそばかすと細かなしわを保ちました。
モデレーションあり、制限つき
軽めのレベルは描画されます。当社のテストでは、中程度のレベルはある回では描画され、別の回では和らげられて返りました。強めのレベルの依頼は和らげられて返り、かなり強めのレベルは課金されずに拒否されました。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
prompt | はい | 必須、最大 5,000 文字。被写体、服装、場所、光、レンズを平易な文章で書きます。 1 文字以上 · 5000 文字以内 |
aspect_ratio | いいえ | 9 種類から 1 つ:1:1(既定)、16:9、9:16、4:3、3:4、3:2、2:3、21:9、9:21。形は料金に影響しません。 |
resolution | いいえ | 1k(既定)は約 100 万画素、2k は長辺 2048 ピクセルです。サイズ段階は料金に影響します。 |
seed | いいえ | 0〜2147483647 の整数(任意)。プロンプトを変えながら再利用すると、バリエーションを並べて比べられますが、同一の画像になる保証はありません。 |
料金
サイズ段階ごとの 1 枚単位の課金で、比率は料金に影響しません。拒否または失敗したリクエストは課金されません。
| 仕様 | 料金 |
|---|---|
| $0.03 / 枚 |
| $0.0391 / 枚 |
ユースケース
ポスターとキャンペーン案
香水、ファッション、商品のコンセプト向けに、見出し、タグライン、写真を 1 つの画面に収めます。
カップルとキャラクターのポートレート
髪、服装、雰囲気が異なる 2 人を自然体のシーンで描きます。物語、ムードボード、キャラクターシート向けです。
どんな形のソーシャル用ビジュアルも
同じプロンプトで、形を変えるだけで、正方形、縦長、横長、超ワイドの画面を作れます。
プロンプトガイドと実践のヒント
文章で書く
被写体、服装、場所、光、レンズは、キーワードの羅列より文章で書くほうがうまくいきます。
文字は引用し、書体も指定する
各行を引用符で囲み、書体を説明します。たとえば、上部に字間の広いセリフ体の見出し、のように書きます。
パレットを固定する
重要な 2〜3 色に 16 進コードを与え、どこに現れるかも書きます。
1k で下書きする
構図は 1k で試し、気に入ったものを 2k で描き直します。サイズ段階は料金に影響します。
比較には seed を使う
1 つの言い回しだけを変える間は 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-pro/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 リファレンスを参照してください。
























