はじめに
FLUX 3 Klein Base 画像編集 は、Black Forest Labs の FLUX 3 Image Klein Base(蒸留していない 5.6B のチェックポイント)で、文章の指示から 1〜3 枚の元画像を変更または組み合わせます。元画像は image 1、image 2、image 3 と呼び、auto で 1 枚目の形を保つか、15 種類から選べます。1k か 2k を選べます。当社のテストでは、1k の編集は約 20〜40 秒で返りました。フィルターはかかりません。
手元の素材からモードを選ぶ
| 手元にあるもの | モード |
|---|---|
| 文章による説明 | FLUX 3 Klein Base テキストから画像 |
| 変更または組み合わせたい 1〜3 枚の画像 | FLUX 3 Klein Base 画像編集 |
主な機能とハイライト
商品写真の服
画像 1 に人物、画像 2 にハンガーに掛かった服の写真を渡すと、編集でその服を着せます。当社のテストでは、冬のパーカーを着た女性が、サウナの更衣室でバーガンディのベルベットのスリップドレスに変わり、顔と髪は保たれました。
同じ人物、新しい場所
赤いジャケットで雪の森を歩いていたハイカーが、服と場所を全部変えても、同じ男性のまま、ヒノキのベンチで前を開けたリネンのシャツ姿になりました。ひげも体格も引き継がれ、短く具体的な指示ほど顔が保たれました。
最大 3 枚を組み合わせる
別々の写真の 2 人の女性が、サウナのベンチで同じ系統のドレス姿の 1 つの場面になり、2 人とも見分けられました。元画像が 3 枚のときは、それぞれが何をもたらすかを書いて、何も落とさないようにしてください。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
prompt | はい | 必須で、5,000 文字まで。残すもの(顔、髪、体格など)を先に書き、そのあとに変更点を書きます。 1 文字以上 · 5000 文字以内 |
image_urls | はい | 必須で、公開画像リンクを 1〜3 件、各 10 MB まで。開けないリンクや画像でないリンクでは、課金されずにリクエストが失敗します。 1 件以上 · 3 件以内 |
aspect_ratio | いいえ | auto(既定)は 1 枚目の元画像の形を保ちます。当社のテストでは、880 x 1184 の縦長のポートレートが、1k では 880 x 1184、2k では 1760 x 2368 で返りました。 |
resolution | いいえ | 1k(既定)か 2k。auto でも適用されます。 |
output_format | いいえ | JPEG(既定)、PNG、WebP。料金は変わりません。 |
seed | いいえ | 任意で、0〜2,147,483,647。LoRA の代わりに、指示の変更を比べるときに再利用します。 |
料金
1 枚ごとに課金されます。出力のサイズティアに加え、元画像 1 枚ごとに料金が加算され、どちらも 2k では高くなります。アスペクト比と出力形式は料金に影響しません。
| 仕様 | 料金 |
|---|---|
| $0.054 / 枚 |
| $0.216 / 枚 |
ユースケース
ルックブックとスタイリング
商品写真の服を、別の写真のモデルに着せて、新しい場所と光の中に置きます。ルックブックやムードボードに向いています。
場所と衣装の変更
人物が誰であるかを保ったまま、1 回の処理で新しい場所と服装に移します。キャラクターシートやシリーズに向いています。
プロンプトガイドと実践のヒント
画像の番号を使う
image 1、image 2、image 3 をアップロードした順に書き、それぞれに役割を与えます。image 1 の女性、image 2 のドレス、という具合です。アスペクト比が auto のときは、1 枚目の画像が形も決めます。
守るものを先に、そのあとに変える
顔、髪、体格など、同じままにするものから始め、そのあと変更点を書きます。服、場所、ポーズ、光です。モデルは服を元のまま残すことがあるので、人物に何を着せたいかを正確に書いてください。
元画像ごとの料金に注意
元画像は 1 枚ごとに料金が加算され、2k ではその加算分が 2 倍になります。1 枚で足りるなら 1 枚にして、1k で下書きしてください。
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-3-klein-base/edit",
"input": {
"aspect_ratio": "auto",
"image_urls": [
"https://example.com/reference.png"
],
"output_format": "jpeg",
"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 リファレンスを参照してください。


























