はじめに
FLUX.2 [max] 編集 は、Black Forest Labs が誇る最高画質の FLUX.2 モデルを、手元にある写真に適用します。1〜3 枚の元画像と指示を受け取り、最初の元画像の形、または 9 種類の比率で、1k か 2k の画像を返します。
手元の素材でモードを選ぶ
| 手元にあるもの | モード |
|---|---|
| 文章の指示 | FLUX.2 Max テキストから画像 |
| 変更または組み合わせたい写真 1〜3 枚 | FLUX.2 Max 編集 |
主な機能とハイライト
最大 3 枚の参考画像
別々の写真にいる人物と場所を、1 回のリクエストで組み合わせます。書店のテストでは、2 枚のポートレートと部屋が 1 つのシーンになり、各人物の顔、髪型、服はそのままで、部屋のランプの光が 2 人にそろって当たりました。
背景と光の変更
スタジオの背景をゴールデンアワーの漁港に替え、被写体の光を整え直します。顔、ひげ、表情、服は変わりません。
編集 1 回につき一律料金
編集は、元画像の枚数やサイズ段階にかかわらず 1 枚あたり一律の料金です。拒否されたリクエストは課金されません。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
prompt | はい | 最大 5,000 文字。何を変え、何を変えないかを書きます。 1 文字以上 · 5000 文字以内 |
image_urls | はい | 元画像 1〜3 枚、各 10 MB まで。人物、部屋、商品など、それぞれが何を担うかをプロンプトに書いてください。 1 件以上 · 3 件以内 |
aspect_ratio | いいえ | auto(既定)は最初の元画像の形を保ち、約 100 万画素で出力します。または 21:9 から 9:21 までの 9 種類から選びます。 |
resolution | いいえ | 1k(既定)または 2k。比率を指定したときだけ有効で、auto の場合は約 100 万画素のままです。 |
seed | いいえ | 0〜2147483647 の整数(任意)。同じプロンプトと元画像で再利用すると変更点を比べやすくなりますが、同一の画像になる保証はありません。 |
料金
$0.076 / 枚
編集 1 回につき 1 枚あたり一律の料金で、元画像の枚数やサイズ段階にかかわらず同じです。失敗または拒否されたリクエストは課金されません。
ユースケース
商品と場所の写真
カタログやキャンペーンの画像向けに、新しい背景、新しい光、統一感のあるシーンを作ります。
普段着のポートレートのレタッチ
普段着の人物のポートレートで、本人と分かる状態を保ったまま、場所、光、スタイルを変えられます。
別々の写真からのグループシーン
個別のポートレートにいる人物を、1 つの部屋や場所に集めます。
プロンプトガイドと実践のヒント
変えない点を書く
変更内容のあとに、動かしてはいけない顔、髪、服、ポーズを書き出します。
元画像に番号を振る
アップロードした順に image 1、image 2、image 3 と呼び、それぞれに役割を与えます。
クリーンで普段着の元写真を使う
編集は厳しくフィルタリングされます。当社のテストでは、Max は軽めのレベルでもポートレートの編集を拒否しました。商品、場所、普通の服装のポートレートが安全な素材です。
フレームを保つなら auto
auto は最初の元画像の形を保ちます。切り取りを変えたい、または 2k にしたいときは、比率とサイズ段階を選んでください。
最大 2 分を見込む
テストでの編集は約 45〜120 秒かかりました。
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-max/edit",
"input": {
"aspect_ratio": "auto",
"image_urls": [
"https://example.com/reference.png"
],
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "1k"
}
}'
# 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 リファレンスを参照してください。

























