はじめに
GPT Image 2.5 Sunburst 画像編集は、OpenAI の gpt-image-2.5-sunburst を手元の画像に適用します。1〜16 枚の元画像、任意の PNG マスク、透明な背景のオプションに対応し、編集の精度が最も重要なときに OpenAI が勧めるモデルです。
手元の素材でモードを選ぶ
| 手元にあるもの | モード |
|---|---|
| 文章のブリーフ | GPT Image 2.5 Sunburst テキストから画像 |
| 変更したい画像 | GPT Image 2.5 Sunburst 画像編集 |
主な機能とハイライト
マスク、忠実度、透過
マスクは描き直しをその透明なピクセルに限定し、input_fidelity high は顔や生地を元画像により近く保ち、background transparent は PNG か WebP で本物のアルファチャンネルを返します。
最大 16 枚の元画像
最大 16 枚の画像から人物、場所、商品を 1 リクエストで組み合わせ、それぞれをプロンプト内の順番で指し示します。元画像 1 枚ごとに出力 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 枚の商品写真を複数の仕上げや色で。商品にマスクをかければ、セットと光はまったく同じままです。
プロンプトガイドと実践のヒント
マスクは元画像に合わせて作る
1 枚目の元画像と同じピクセルサイズの PNG で、描き直す部分だけを透明にします。不透明な部分はすべて守られます。
守るものの一覧を書き出す
変更点のあとに、残すべきもの(顔、髪、ポーズ、椅子、光)を書いてください。モデルは暗黙の了解より書かれた一覧に確実に従います。
切り抜きでは残すものを書く
残す被写体と、背景を完全に透明にすることを書き、output_format を png か webp にしてください。
レイアウトの前にアルファを確認する
返ってきた PNG や WebP をレイアウトツールで開いてください。空いた部分は本物のアルファチャンネルなので、キーイングやマスクの工程を追加する必要はありません。
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-sunburst/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 リファレンスを参照してください。





