はじめに
FLUX.2 [klein] 9B 画像編集は、Black Forest Labs が 2026 年 1 月 15 日に公開した小型で高速な画像モデルの編集モードです。1〜3 枚の元画像と指示を受け取り、約 100 万画素、または選んだ 1k・2k の段階で JPEG を返します。コンテンツフィルターはありません。
手元にあるものでモードを選ぶ
| 手元にあるもの | モード |
|---|---|
| 文章の指示 | FLUX.2 Klein 9B テキストから画像 |
| 変更したい画像 | FLUX.2 Klein 9B 画像編集 |
主な機能とハイライト
同じ人物、新しいルック
当社のテストでは、服や背景を変えても、顔、髪、ポーズは保たれました。そのままにする点を挙げてから、変更点を書いてください。
編集しながらサイズを変える
形状とサイズの段階を選べば、編集結果は長辺 2048 ピクセルで返ります。auto なら元の形のままです。
一律料金
元画像が 1 枚でも 3 枚でも、1k でも 2k でも、編集の料金は変わりません。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
prompt | はい | 必須で、最大 5,000 文字。変えたい点と、そのままにする点(顔、髪、ポーズなど)を書き、新しい服があれば名前を挙げます。 1 文字以上 · 5000 文字以内 |
image_urls | はい | 必須で、元画像を 1〜3 枚、1 枚あたり 10 MB まで、プロンプトで触れる順に指定します。枚数で料金は変わりません。 1 件以上 · 3 件以内 |
aspect_ratio | いいえ | auto(既定)は最初の元画像の形を保ち、約 100 万画素で出力します。21:9 から 9:21 までの 9 種類から選ぶこともできます。 |
resolution | いいえ | 1k(既定)か 2k で、アスペクト比を選んだときだけ使われます。auto では約 100 万画素のままです。 |
seed | いいえ | 任意の 0〜2,147,483,647 の整数です。プロンプトの変更を並べて比べたいときに再利用します。 |
料金
$0.016 / 枚
元画像の枚数や、サイズが 1k か 2k かに関係なく、1 枚あたり一律の料金です。失敗または拒否されたリクエストには課金されません。
ユースケース
服や場面の入れ替え
人物を見分けられるまま、服、部屋、時間帯を変えます。
写真の素早いバリエーション
コーヒー 1 杯の時間で、1 枚の写真のいくつもの雰囲気を試せます。
最大 3 枚の元画像を組み合わせる
人物、場所、小物を 1 つのフレームにまとめ、それぞれプロンプトで呼びます。
プロンプトガイドと実践のヒント
そのままにする点を書く
顔、髪、ポーズ、座っている位置を書き、そのあとで変更点を 1〜2 文で説明します。
新しい服の名前を書く
仕立てと生地を指定してください。当社のテストでは、編集はプロンプトで名前を挙げた服に従いました。
一度に変えるのは 1 つ
大きな変換は、2 回の編集に分けて重ねます。
2k にするなら形を選ぶ
auto は約 100 万画素です。2k の段階にしたいときは、形状を選んでください。
手と顔を確認する
小型モデルはどちらも崩れることがあります。崩れたら、別の 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-klein-9b/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 リファレンスを参照してください。
























