はじめに
FLUX.2 [klein] 4B 画像編集は、Apache 2.0 のオープンソースである Black Forest Labs の最小の FLUX.2 モデルで、最大 3 枚の元画像を文章の指示で変更または合成します。auto で最初の画像の形を保つか、比率と 1k・2k のサイズの段階を選べます。編集は 1 枚あたり一律の料金で、コンテンツフィルターはかかりません。
手元にあるものでモードを選ぶ
| 手元にあるもの | モード |
|---|---|
| 文章の説明 | FLUX.2 Klein 4B テキストから画像 |
| 変更または合成したい 1〜3 枚の画像 | FLUX.2 Klein 4B 画像編集 |
主な機能とハイライト
最大 3 枚の参照
2 枚のポートレートと場所を組み合わせたり、1 枚の写真をスタイル変更したりできます。元画像の枚数で料金は変わりません。
人物を保つ編集
新しい背景、光、天気を頼みながら、顔、服、ポーズを保てます。元画像が 1 枚ならきれいに働きますが、3 枚では顔が少しずれることがあります。
オープンで、フィルターなし
何も審査されず、拒否もされません。当社のテストでは、編集はフィルターなしの元画像をそのまま残しました。かなり強めのレベルだけが和らげられて返ってきました。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
prompt | はい | 変えたい点とそのままにする点を書き、最大 5,000 文字です。元画像が複数のときは、画像 1、画像 2、画像 3 と呼びます。 1 文字以上 · 5000 文字以内 |
image_urls | はい | 元画像を 1〜3 枚、1 枚あたり 10 MB まで、プロンプトで触れる順に指定します。必須です。 1 件以上 · 3 件以内 |
aspect_ratio | いいえ | auto(既定)は最初の元画像の形を保ち、約 100 万画素で出力します。21:9 から 9:21 までの 9 種類の比率から選ぶこともできます。 |
resolution | いいえ | 1k(既定)か 2k(長辺 2048 ピクセル)です。比率を選んだときだけ使われ、auto では約 100 万画素のままです。 |
seed | いいえ | 0〜2147483647 の数値です。プロンプトの細部を 1 つ変えながら、編集結果を比べるときに再利用します。 |
料金
$0.013 / 枚
元画像の枚数やサイズの段階に関係なく、1 枚あたり一律の料金です。失敗したリクエストには課金されません。
ユースケース
背景や雰囲気の入れ替え
晴れた通りのカップルを、雨のネオンの夜へ、1 回の処理で移せます。
人物を場所に連れてくる
ストーリーボード、カバー、キャラクターシートのために、2 枚のポートレートを場所の写真に配置します。
素早いスタイル変更
構図はそのままに、光、季節、配色を変えます。
プロンプトガイドと実践のヒント
先に守り、あとで変える
まずそのままにする点を書き、変更点だけを描写します。短く具体的な指示がもっともよく通ります。
元画像にそれぞれ役割を与える
画像が複数のときは、それぞれが何を担うかを書きます。この人物、あの人物、この場所、というように。
細部を確認する
元画像が 2〜3 枚のときは、手、髪、アクセサリーを確認してください。小さな余分な物が現れることがあります。何かおかしければ、別の 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-4b/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 リファレンスを参照してください。

























