はじめに
GPT Image 2.5 Flare 画像編集は、OpenAI の gpt-image-2.5-flare を手元の画像に適用します。1〜16 枚の元画像、PNG マスク、透明な背景のオプションに対応し、対話的に使えるほど速く編集結果を返します。
手元の素材でモードを選ぶ
| 手元にあるもの | モード |
|---|---|
| 文章のブリーフ | GPT Image 2.5 Flare テキストから画像 |
| 変更したい画像 | GPT Image 2.5 Flare 画像編集 |
主な機能とハイライト
複数の元画像からの手早い合成
2 枚以上の元画像を 1 つの場面にまとめ、顔はそれぞれの画像のまま保ちます。私たちの 2 枚の元画像の例は、1 分よりずっと短い時間で終わりました。
マスクと切り抜き
PNG マスクで描き直しを 1 か所に限定でき、background transparent は PNG か WebP で本物のアルファチャンネルを返すので、キーイングなしでレイアウトに使えます。
1 回で複数の変更
服、時間帯、天気を同時に変えられます。ただしプロンプトには変えないものも書いてください。私たちのテラスの例では、1 リクエストでドレスと光を変えました。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
prompt | はい | 最大 5,000 文字です。画像内に入れたい語句はすべて二重引用符で囲み、置く場所も書いてください。 1 文字以上 · 5000 文字以内 |
image_urls | はい | 元画像は 1〜16 枚です。プロンプトでは順番で指し示してください(1 枚目の画像、2 枚目の画像)。 1 件以上 · 16 件以内 |
mask_url | いいえ | 1 枚目の元画像と同じサイズの PNG で、任意です。透明なピクセルが描き直す範囲を示し、不透明な部分はそのまま残ります。 |
aspect_ratio | いいえ | 1:3 から 3:1 までの 15 種類で、既定は 1:1 です。仕上がりは元画像ではなく選んだ比率になり、比率によって料金が変わります。 |
resolution | いいえ | 1k(既定)、2k、4k のいずれかです。正方形の画像は一辺 1024、2048、2880 ピクセルになり、段階が上がるほど 1 枚あたりの料金も上がります。 |
quality | いいえ | low、medium、high(既定)、xhigh、max のいずれかです。段階が上がるほど精細になり、時間も料金もかかります。 |
num_outputs | いいえ | 1 リクエストあたり 1〜10 枚で、既定は 1 枚です。画像ごとに個別に課金されます。 |
input_fidelity | いいえ | low(既定)か high です。high では元画像の顔、生地、印刷された細部をより忠実に保ちます。 |
background | いいえ | auto(既定)、transparent、opaque のいずれかです。transparent には png か webp の出力が必要で、本物のアルファチャンネルが返ります。 |
output_format | いいえ | png(既定)、jpeg、webp のいずれかです。料金は変わりません。 |
output_quality | いいえ | jpeg と webp の圧縮品質で、0〜100 の範囲です。値が大きいほど細部が残り、ファイルも大きくなります。 |
official_fallback | いいえ | 既定はオンです。1:1、3:2、2:3、4:3、3:4、16:9、9:16 のいずれかの比率で、マスクなし、input fidelity low、background auto のまま high 品質・1k サイズの PNG を 1 枚返す編集のリクエストは、まずエコノミールートで実行されます。 デフォルト値: |
料金
出力画像 1 枚ごとに、品質、サイズ段階、比率で課金します。公式ルートでは、元画像 1 枚ごとに出力 1 枚あたりの固定料金も加わります。合計は送信前に見積もりで表示されます。1:1、3:2、2:3、4:3、3:4、16:9、9:16 のいずれかの比率で、マスクなし、input fidelity low、background auto のまま high 品質・1k サイズの PNG を 1 枚返す編集のリクエストは、エコノミールートでエコノミー価格から始まります。Official fallback(既定はオン)が有効なら、そのルートが拒否したリクエストや完了できなかったリクエストは公式ルート(公式価格)で実行し直されるため、見積もりには開始価格と上限額の両方が表示されます。拒否されたリクエストは課金されません。公式ルートでは、最初の 100 トークンを超える長いプロンプトに入力トークンの少額料金が 1 リクエストにつき 1 回加わります。中国語・日本語・韓国語の文字はおよそ 1 文字 1 トークンです。
| 仕様 | 料金 |
|---|---|
| $0.001816 / 枚 |
| $0.001816 / 枚 |
| $0.00244 / 枚 |
| $0.00244 / 枚 |
| $0.002752 / 枚 |
| $0.002752 / 枚 |
| $0.00304 / 枚 |
| $0.00304 / 枚 |
| $0.003568 / 枚 |
| $0.003568 / 枚 |
| $0.003808 / 枚 |
| $0.003808 / 枚 |
| $0.003856 / 枚 |
| $0.003856 / 枚 |
| $0.004192 / 枚 |
| $0.004192 / 枚 |
| $0.004744 / 枚 |
| $0.004744 / 枚 |
| $0.005104 / 枚 |
| $0.00568 / 枚 |
| $0.00568 / 枚 |
| $0.00652 / 枚 |
| $0.00652 / 枚 |
| $0.007312 / 枚 |
| $0.007312 / 枚 |
| $0.008176 / 枚 |
| $0.008176 / 枚 |
| $0.008728 / 枚 |
| $0.008728 / 枚 |
| $0.010936 / 枚 |
| $0.01396 / 枚 |
| $0.01396 / 枚 |
| $0.018592 / 枚 |
| $0.018592 / 枚 |
| $0.020998 / 枚 (Official fallback 使用時:最大 $0.023992) |
| $0.020998 / 枚 (Official fallback 使用時:最大 $0.023992) |
| $0.021472 / 枚 |
| $0.021472 / 枚 |
| $0.022 / 枚 (Official fallback 使用時:最大 $0.028) |
| $0.022 / 枚 (Official fallback 使用時:最大 $0.028) |
| $0.022864 / 枚 (Official fallback 使用時:最大 $0.031456) |
| $0.022864 / 枚 (Official fallback 使用時:最大 $0.031456) |
| $0.024136 / 枚 |
| $0.024136 / 枚 |
| $0.025636 / 枚 (Official fallback 使用時:最大 $0.042544) |
| $0.0316 / 枚 |
| $0.0316 / 枚 |
| $0.034504 / 枚 |
| $0.034504 / 枚 |
| $0.037864 / 枚 |
| $0.037864 / 枚 |
| $0.043504 / 枚 |
| $0.043504 / 枚 |
| $0.049816 / 枚 |
| $0.049816 / 枚 |
| $0.054616 / 枚 |
| $0.054616 / 枚 |
| $0.055624 / 枚 |
| $0.055624 / 枚 |
| $0.059872 / 枚 |
| $0.059872 / 枚 |
| $0.07144 / 枚 |
| $0.07144 / 枚 |
| $0.075328 / 枚 |
| $0.082936 / 枚 |
| $0.082936 / 枚 |
| $0.096472 / 枚 |
| $0.096472 / 枚 |
| $0.110728 / 枚 |
| $0.110728 / 枚 |
| $0.124624 / 枚 |
| $0.124624 / 枚 |
| $0.135064 / 枚 |
| $0.135064 / 枚 |
| $0.168976 / 枚 |
| $0.002872 / 枚 |
| $0.002872 / 枚 |
| $0.004456 / 枚 |
| $0.004456 / 枚 |
| $0.005152 / 枚 |
| $0.005152 / 枚 |
| $0.005704 / 枚 |
| $0.005704 / 枚 |
| $0.006328 / 枚 |
| $0.006328 / 枚 |
| $0.006712 / 枚 |
| $0.006712 / 枚 |
| $0.007312 / 枚 |
| $0.007312 / 枚 |
| $0.008128 / 枚 |
| $0.008128 / 枚 |
| $0.009088 / 枚 |
| $0.009088 / 枚 |
| $0.009928 / 枚 |
| $0.01108 / 枚 |
| $0.01108 / 枚 |
| $0.01276 / 枚 |
| $0.01276 / 枚 |
| $0.014176 / 枚 |
| $0.014176 / 枚 |
| $0.015904 / 枚 |
| $0.015904 / 枚 |
| $0.017296 / 枚 |
| $0.017296 / 枚 |
| $0.021808 / 枚 |
| $0.024112 / 枚 |
| $0.024112 / 枚 |
| $0.03688 / 枚 |
| $0.03688 / 枚 |
| $0.041896 / 枚 |
| $0.041896 / 枚 |
| $0.043072 / 枚 |
| $0.043072 / 枚 |
| $0.048064 / 枚 |
| $0.048064 / 枚 |
| $0.055432 / 枚 |
| $0.055432 / 枚 |
| $0.062416 / 枚 |
| $0.062416 / 枚 |
| $0.062944 / 枚 |
| $0.062944 / 枚 |
| $0.067984 / 枚 |
| $0.067984 / 枚 |
| $0.07624 / 枚 |
| $0.07624 / 枚 |
| $0.086032 / 枚 |
| $0.087496 / 枚 |
| $0.087496 / 枚 |
| $0.095248 / 枚 |
| $0.095248 / 枚 |
| $0.098968 / 枚 |
| $0.098968 / 枚 |
| $0.110656 / 枚 |
| $0.110656 / 枚 |
| $0.121312 / 枚 |
| $0.121312 / 枚 |
| $0.142816 / 枚 |
| $0.142816 / 枚 |
| $0.152632 / 枚 |
| $0.171016 / 枚 |
| $0.171016 / 枚 |
| $0.19456 / 枚 |
| $0.19456 / 枚 |
| $0.220456 / 枚 |
| $0.220456 / 枚 |
| $0.248464 / 枚 |
| $0.248464 / 枚 |
| $0.274216 / 枚 |
| $0.274216 / 枚 |
| $0.342928 / 枚 |
| $0.003736 / 枚 |
| $0.003736 / 枚 |
| $0.006016 / 枚 |
| $0.006016 / 枚 |
| $0.0076 / 枚 |
| $0.0076 / 枚 |
| $0.008368 / 枚 |
| $0.008368 / 枚 |
| $0.009304 / 枚 |
| $0.009304 / 枚 |
| $0.011176 / 枚 |
| $0.011176 / 枚 |
| $0.01192 / 枚 |
| $0.01192 / 枚 |
| $0.0124 / 枚 |
| $0.0124 / 枚 |
| $0.01324 / 枚 |
| $0.01324 / 枚 |
| $0.016216 / 枚 |
| $0.0166 / 枚 |
| $0.0166 / 枚 |
| $0.02116 / 枚 |
| $0.02116 / 枚 |
| $0.023872 / 枚 |
| $0.023872 / 枚 |
| $0.026296 / 枚 |
| $0.026296 / 枚 |
| $0.028552 / 枚 |
| $0.028552 / 枚 |
| $0.032272 / 枚 |
| $0.032272 / 枚 |
| $0.035992 / 枚 |
| $0.050776 / 枚 |
| $0.050776 / 枚 |
| $0.056176 / 枚 |
| $0.056176 / 枚 |
| $0.0652 / 枚 |
| $0.0652 / 枚 |
| $0.080464 / 枚 |
| $0.080464 / 枚 |
| $0.086752 / 枚 |
| $0.086752 / 枚 |
| $0.094288 / 枚 |
| $0.094288 / 枚 |
| $0.103984 / 枚 |
| $0.103984 / 枚 |
| $0.11296 / 枚 |
| $0.11296 / 枚 |
| $0.115576 / 枚 |
| $0.115576 / 枚 |
| $0.127864 / 枚 |
| $0.127864 / 枚 |
| $0.14272 / 枚 |
| $0.14272 / 枚 |
| $0.14272 / 枚 |
| $0.168592 / 枚 |
| $0.168592 / 枚 |
| $0.184552 / 枚 |
| $0.184552 / 枚 |
| $0.197104 / 枚 |
| $0.197104 / 枚 |
| $0.201832 / 枚 |
| $0.201832 / 枚 |
| $0.253408 / 枚 |
| $0.259552 / 枚 |
| $0.259552 / 枚 |
| $0.320608 / 枚 |
| $0.320608 / 枚 |
| $0.37588 / 枚 |
| $0.37588 / 枚 |
| $0.414736 / 枚 |
| $0.414736 / 枚 |
| $0.456544 / 枚 |
| $0.456544 / 枚 |
| $0.569656 / 枚 |
ユースケース
着せ替えとリスタイル
ルックブックやキャンペーンのラフ用に、同じ人物を新しい服や新しい場所で見せ、1 リクエストで複数の候補を出します。
別々に撮った人物をまとめる
別々に撮影した 2 人を同じ画像に置き、ポスター、サムネイル、ストーリーのパネルに使います。
季節ごとの更新
夏のキャンペーン画像を次の季節向けに秋や夜の版へ変え、人物と商品はそのまま残します。
プロンプトガイドと実践のヒント
元画像ごとに役割を与える
男性と戸口は 1 枚目、女性は 2 枚目から、と書いてください。順番がプロンプトと元画像を結ぶ唯一の手がかりです。
関連する変更はまとめる
新しい服と別の時間帯は 1 リクエストでうまく表現できます。関係のない変更は別々の編集にしたほうがうまくいきます。
顔には忠実度を上げる
編集後も顔を見分けられるままにしたいときは input_fidelity を high にしてください。料金は変わりません。
背景の差し替えにはマスクを
背景だけを変えるときは、1 枚目の元画像と同じサイズの PNG マスクで、被写体を不透明、背景を透明にしてください。
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": "openai/gpt-image-2.5-flare/edit",
"input": {
"aspect_ratio": "1:1",
"background": "auto",
"image_urls": [
"https://example.com/reference.png"
],
"input_fidelity": "low",
"num_outputs": 1,
"output_format": "png",
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette"
}
}'
# 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 リファレンスを参照してください。





