はじめに
FLUX.1 Kontext [pro] テキストから画像は、Black Forest Labs が 2025 年 5 月 29 日に公開した 2 つの商用 Kontext モデルのうち、速いほうの層です。Kontext はインコンテキスト型として作られており、文章から絵を描いたのと同じネットワークが、あとからその絵を受け取って 1 か所だけ変えることができます。このエンドポイントはそのループの前半です。場面を書けば約 100 万画素の写真が返り、気に入った 1 枚は衣装や光、看板の文字を変えたいときに編集エンドポイントへそのまま送れます。
手元の素材でモードを選ぶ
| 手元にあるもの | モード |
|---|---|
| 文章で書いた場面だけ | FLUX.1 Kontext [pro] テキストから画像 |
| 変えたい写真が 1 枚 | FLUX.1 Kontext [pro] 編集 |
主な機能とハイライト
置いた場所に文字が入る
Kontext [pro] は引用符で囲んだ言葉を、描くべき文字として読みます。ドレッサーのテストでは鏡に口紅のメモを頼み、「Room 412 - Midnight」が赤い手書きの線でガラスに描かれました。モーテルのテストでは「PALM COURT」がピンクの筆記体ネオンになり、どちらも書いたとおりの綴りでした。
6 つの比率、どれも約 100 万画素
正方形、横長 2 種、縦長 2 種、そして 21:9 の超横長です。どの比率もおよそ 100 万画素で返り、今回の実測では 16:9 が 1280x720、3:4 が 864x1152、21:9 が 1520x656 でした。
あとから編集する前提の設計
ここで作った画像はそのまま編集エンドポイントに渡せます。同じモデルが顔とポーズを保ったまま服や天気、文字を変えるので、ここで描いた場面はシリーズの最初の 1 枚に向いています。
待ち時間が短い
テキストから画像の実行は、21:9 や 9:16 も含めてほとんどが 10〜30 秒で返りました。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
prompt | はい | 必須、5,000 文字まで。人物、服装、場所、光、レンズを文章で書きます。 1 文字以上 · 5000 文字以内 |
aspect_ratio | いいえ | 1:1(既定)、16:9、9:16、4:3、3:4、21:9 のいずれかです。どの形も約 100 万画素で、料金は同じです。 |
output_format | いいえ | jpeg(既定)はファイルが小さく、png は可逆圧縮です。形式で料金は変わりません。 |
enable_prompt_expansion | いいえ | 既定はオフです。オンにすると Kontext [pro] が描く前にプロンプトへ描写を足すので、短いプロンプトに役立ちますが、少し時間がかかることがあります。 デフォルト値: |
料金
$0.028 / 枚
Kontext [pro] のテキストから画像は 1 枚ごとの課金で、形、形式、プロンプト拡張で料金は変わりません。拒否・失敗したリクエストは課金されません。
ユースケース
人物と衣装のボード
物語に合う場面で人物を一度描き、毎回別人を引き直す代わりに、その 1 枚から編集で衣装や雰囲気を枝分かれさせます。
看板、メモ、小道具
ホテルのドア、ネオンサイン、手書きのメモ、ラベルなど、決まった場所に決まった言葉が必要なもの。
SNS とキャンペーン用の画
同じ文章から、ストーリー用の 9:16、ヘッダー用の 16:9、バナー用の 21:9 を作れます。
プロンプトガイドと実践のヒント
タグの羅列ではなく撮影内容を書く
誰が、何を着て、どこにいて、光はどこから来て、どんなレンズの雰囲気か。Kontext [pro] はキーワードの羅列より普通の文章によく従います。
入れたい言葉はすべて引用符で
文字は引用符で正確に書き、鏡の上、ドアの上、チケットの上など、どこに入るかも書きます。
短いプロンプトには拡張を
1 行だけのプロンプトは素っ気ない仕上がりになることがあります。プロンプト拡張をオンにするとモデルが細部を補い、文言を一字一句守りたいときはオフのままにします。
編集の段階を見越しておく
あとで衣装を変えるつもりなら、顔、髪、ポーズを今のうちにはっきり書いておきます。編集はそこを手がかりに保ちます。
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-1-kontext-pro/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"aspect_ratio": "1:1",
"output_format": "jpeg"
}
}'
# 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 リファレンスを参照してください。


























