はじめに
FLUX.1 Kontext [max] 編集は、Black Forest Labs が 2025 年 5 月 29 日に公開したプレミアムな Kontext モデルで、写真 1 枚を文章の指示に沿って作り変えたり修正したりします。時代、時刻、季節のように画面全体に及ぶ編集で、それでも人物と文字を無傷で残したいときに選ぶ層です。
素材から選ぶモード
| 手元にあるもの | モード |
|---|---|
| 作り変えたい完成写真が 1 枚 | FLUX.1 Kontext [max] 編集 |
| 画像はまだなく、文章の場面だけ | FLUX.1 Kontext [max] テキストから画像 |
主な機能とハイライト
配役を保ったまま画面全体を作り変える
屋上のカップルを、硬いキーライトの 1950 年代モノクロのフィルム・ノワールのスチルにしました。2 人の顔、抱擁、ドレスのシルエットは引き継がれ、壁の看板も読めるまま残りました(新しい構図で少しだけ切れています)。
時刻と季節の入れ替え
夜行列車の寝台を雪山の朝焼けに変え、赤いローブはアイボリーのシルクに、ワイングラスはコーヒーカップになりました。女性の顔と脚を組んだポーズは変わっていません。
1 つの指示で複数の変更
寝台の編集で、Kontext [max] は光、衣服、小道具の 3 つを一度にこなし、それぞれほかを乱さずに反映しました。
形は元画像に従う
auto なら元の構図を保ちます。16:9 の屋上は 1328x752、3:4 の寝台は 864x1152 で返りました。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
prompt | はい | 必須、5,000 文字まで。先に新しいルックや変更を書き、次に固定項目(顔、ポーズ、服の形、残す文字)を書きます。 1 文字以上 · 5000 文字以内 |
image_url | はい | 必須。Kontext [max] が編集する写真 1 枚で、10 MB までの JPEG、PNG、WebP です。 1 文字以上 |
aspect_ratio | いいえ | auto(既定)は元の写真に従います。1:1、16:9、9:16、4:3、3:4、21:9 を選ぶと構図を変えます。 |
output_format | いいえ | jpeg(既定)または png で、料金の差はありません。 |
enable_prompt_expansion | いいえ | 既定はオフです。オンにすると Kontext [max] が編集する前に指示へ描写が足されます。 デフォルト値: |
料金
$0.056 / 枚
Kontext [max] の編集は 1 回ごとに、テキストから画像と同じ定額の 1 枚料金です。拒否や失敗に終わったリクエストには料金がかかりません。
ユースケース
時代とジャンルのルック
フィルム・ノワール、1970 年代のカラーフィルム、光沢のある雑誌調など、1 枚の写真をキャンペーンやムードボード用に別の時代で撮り直します。
1 日を通した連続性
同じ人物が写る同じ場面の、朝、夕焼け、夜のバージョンです。
完成した画の衣装と小道具の変更
気に入っている画像のローブ、グラス、バッグ、帽子を差し替えます。
惜しい 1 枚を救う
ほとんど良い画像の 1 か所だけを直し、作り直さずに済ませます。
プロンプトガイドと実践のヒント
ルックを言ってから固定項目を
「1950 年代のモノクロのフィルム・ノワールのスチルに作り変えて」と書き、続けて「2 人の顔、ポーズ、看板はそのまま」と書きます。
関連する変更はまとめる
朝焼けとアイボリーのローブとコーヒーのように、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-max/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 リファレンスを参照してください。


























