はじめに
FLUX.1 Kontext [pro] 編集は、写真 1 枚と文章の指示を受け取り、その指示を反映した同じ写真を返します。Black Forest Labs は 2025 年 5 月 29 日、文脈の中で編集するモデルとして Kontext を公開しました。場面をゼロから描き直すのではなく送られた画像を読むため、テキストから画像のモデルなら作り直しになるような編集でも、顔、ポーズ、部屋、文字が残ります。
手元の素材でモードを選ぶ
| 手元にあるもの | モード |
|---|---|
| 変えたい写真が 1 枚 | FLUX.1 Kontext [pro] 編集 |
| 文章で書いた場面だけ | FLUX.1 Kontext [pro] テキストから画像 |
主な機能とハイライト
部分だけ変え、ほかはそのまま
ドレッサーのテストでは、シャンパン色のサテンのスリップを黒いレースに替えました。顔、髪、電球の明かり、鏡の口紅の文字は元の位置のままでした。
同じ 1 枚で天気、時刻、光を変える
モーテルのプールを夕暮れから雨の夜に変えました。水面に雨、濡れたタイルにネオンの映り込み、シャツはずぶ濡れで、男性の顔とポーズは変わっていません。
看板や文字は編集後も残る
写真にすでにある文字は、変えるよう頼まない限りそのまま残り、新しい文字は引用符で書けば追加できます。
元の比率を保つことも、新しく決めることも
アスペクト比を auto にすると結果は元画像に従います。1344x768 の写真は 1328x752、正方形は 992x992 で返りました。比率を選ぶとトリミングまたは拡張になります。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
prompt | はい | 必須、5,000 文字まで。最初に変更を書き、次に保つもの(顔、髪、ポーズ、背景、すでにある文字)を挙げます。 1 文字以上 · 5000 文字以内 |
image_url | はい | 必須。10 MB までの JPEG、PNG、WebP の写真 1 枚です。 1 文字以上 |
aspect_ratio | いいえ | auto(既定)は元写真の形を保ちます。1:1、16:9、9:16、4:3、3:4、21:9 を選ぶとフレームをトリミングまたは拡張します。 |
output_format | いいえ | jpeg(既定)または png です。形式で料金は変わりません。 |
enable_prompt_expansion | いいえ | 既定はオフです。オンにすると編集前に指示へ細部が足されます。 デフォルト値: |
料金
$0.028 / 枚
Kontext [pro] の編集は、元画像のサイズや形にかかわらずテキストから画像と同じ 1 枚ごとの課金です。拒否・失敗したリクエストは課金されません。
ユースケース
衣装とスタイリングの差し替え
1 枚のポートレートからサテン、レース、ブレザー、ローブなど、同じ元画像からそれぞれ別の編集として複数のルックを作ります。
ムードと光のバリエーション
昼から夜、晴れから雨、暖色から寒色へ、写っている人物を失わずに変えます。
シリーズの連続性
各結果を次の元画像として送り込み、小さく制御された変化を重ねて人物を場面から場面へ動かします。
細部の修正
看板の文言を変える、物を消す、服の色を変える、といった作業です。
プロンプトガイドと実践のヒント
まず変更、次に固定するもの
最初に「スリップを黒いレースに替えて」、続けて「顔、髪、ポーズ、鏡の文字はまったく同じままに」と書きます。
見た目で呼ぶ
「彼女の服」ではなく「シャンパン色のサテンのスリップ」と書きます。モデルは説明から範囲を見つけます。
1 回に 1 つの変更
1 つの長い指示ですべてを書き換えるより、小さな編集を続けるほうが人物の同一性を保てます。
元の形には auto
フレームをトリミングまたは拡張したいときだけ比率を指定します。
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/edit",
"input": {
"aspect_ratio": "auto",
"image_url": "https://example.com/reference.png",
"output_format": "jpeg",
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette"
}
}'
# 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 リファレンスを参照してください。


























