はじめに
FLUX.2 Dev 画像編集は、Black Forest Labs の 320 億パラメーターのオープンウェイトモデル FLUX.2 [dev] で、最大 3 枚の元画像を変更または合成します。新しい服装、場所、光を書き、そのままにする点を指定すると、画像が 1 枚返ります。顔は元の写真に近いまま保たれ、別々の写真の人物を 1 つの場面に置くこともでき、元画像にも、プロンプトにも、結果にも、フィルターはかかりません。
手元にあるものでモードを選ぶ
| 手元にあるもの | モード |
|---|---|
| 変更または合成したい 1〜3 枚の画像 | FLUX.2 Dev 画像編集 |
| 文章の指示だけ | FLUX.2 Dev テキストから画像 |
主な機能とハイライト
最大 3 枚の参照
プロンプトで触れる順に画像を並べ、画像 1、画像 2、画像 3 と呼びます。当社のテストでは、あるポートレートの女性と別のポートレートの男性が新しい場面で踊り、どちらの顔も元の写真に近いままでした。
元の構図に従うフレーミング
形状が auto なら、結果は最初の画像の比率のまま、約 100 万画素で返ります。切り抜きを変えたいときや画素数を増やしたいときは、比率と 2k を選びます。
一律料金
1 枚、2 枚、3 枚のどの場合も、1k でも 2k でも、1 枚あたりの料金は変わりません。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
prompt | はい | 最大 5,000 文字。変えたい点と、そのままにする点を書いてください。 1 文字以上 · 5000 文字以内 |
image_urls | はい | 元画像を 1〜3 枚、1 枚あたり 10 MB まで、プロンプトで触れる順(「画像 1」「画像 2」)に指定します。鮮明な正面の写真ほど、顔がよく保たれます。 1 件以上 · 3 件以内 |
aspect_ratio | いいえ | auto(既定)は最初の元画像の形に従い、約 100 万画素で出力します。21:9 から 9:21 までの 9 種類から選ぶと、切り直せます。 |
resolution | いいえ | 1k(既定)か 2k で、特定のアスペクト比を選んだときだけ使われます。auto では約 100 万画素のままです。 |
seed | いいえ | 0〜2,147,483,647 の整数です。プロンプトを調整しながら固定すると、結果を見比べやすくなります。 |
料金
$0.023 / 枚
元画像の枚数やサイズの段階に関係なく、1 枚あたり一律の料金です。失敗したリクエストには課金されません。
ユースケース
同じ人物の新しい服装と場面
オフィスからバーへ、街角からビーチへと、服装や光を変えながら、顔はそのままに人物を移せます。
2 人を 1 つの場面に
別々のポートレートの人物を 1 つのフレームにまとめ、カップルの写真やキャラクターのペアに使えます。
ライティングや色の変更
16 進コードで新しい光源を指定し、構図の残りはそのままにできます。
プロンプトガイドと実践のヒント
変えない点を先に書く
まず「same man, same face and beard」のように書き、そのあとで変更点を並べます。長い説明よりも、短く明確な箇条書きのほうがよく通ります。
人物に番号を振る
写真を組み合わせるときは、「the woman from image 1 and the man from image 2」と書き、どちらの顔も写真のまま保つよう頼みます。
大事なときは 1 フレーム 1 人にする
「alone in the frame, no other people」と添えると、背景に余計な人物が現れるのを防げます。
まず auto から
最初は形状を auto のままにします。内容が気に入ってから比率と 2k を選び、seed を固定して大きい版を見比べましょう。
鮮明な元画像を使う
明るく正面を向いた写真ほど、顔がよく引き継がれます。2 人目、3 人目は、1 人目より少し安定しません。
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-dev/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 リファレンスを参照してください。
























