Skip to main content
POST
Image editing: edit or fuse reference images with locked output size
右側のインタラクティブなプレイグラウンドでは、ローカル画像を直接アップロードできます。API Key を Authorization フィールドに入力し(形式: Bearer sk-xxx)、画像を選択して、prompt / model / size を設定し、送信をクリックします。
範囲: このページは、1枚以上の参照画像を編集または融合するためのものです。リクエストでは multipart/form-data を使用します。純粋なテキストから画像生成の場合は、Text-to-Image エンドポイント を参照してください。gpt-image-2-allとの違い: 呼び出し構造は同じで、size フィールドが 1 つ追加されるだけです。サイズを固定する必要がなく、最速の出力を求めるなら、gpt-image-2-all を使用してください。
🖥️ ブラウザのプレイグラウンドの制限このエンドポイントは、デフォルトで base64 文字列(b64_json)を返します。これは数MBになることがあるため、ブラウザのプレイグラウンドでは 请求时发生错误: unable to complete request と表示される場合があります — 実際にはリクエストは成功しています。ブラウザがそのように長い base64 文字列をレンダリングできないだけです。推奨ワークフロー: base64 が必要な場合や、非常に大きな参照画像をアップロードする必要がある場合は、下のコードサンプルをコピーしてローカルで実行してください
📎 複数画像の融合では順序が重要ですimage フィールドは複数の参照画像を受け付けます。順序が、プロンプト内での「image1 / image2 / image3」参照の基準になります。 プロンプトでは明示的に参照してください。例:
image1 の人物を image2 のシーンに配置し、image3 の画風で
推奨は1画像あたり 10MB 以下で、形式は png / jpg / webp です。大きすぎる画像はゲートウェイの制限に引っかかる場合があります。
🎯 形状を維持する編集: size=auto を指定した場合(または size を省略した場合)、出力はプロンプトが編集対象として指定した参照画像のアスペクト比を引き継ぎます — 複数画像のシナリオでは必ずしも1枚目ではありませんたとえば、プロンプトが「image2 を修正し、image2 の服と帽子を image1 に合わせる」で、image2 が 1:1 の場合、出力も 1:1 になります(image1 が横長の 16:9 でも同様です)。服の差し替え、アクセサリーの追加、レタッチ、その他の形状を維持する編集に便利です。プロンプトが対象を指定しない場合はモデルが自動で決めます。アスペクト比を変更する必要がある場合にのみ、明示的な 30バケットの size を指定してください。
⚠️ 主要パラメータの注意点
  • size: 編集時は auto を優先してください(またはフィールドを省略してください) — モデルはプロンプトが編集対象として指定した参照画像のアスペクト比を維持します。複数画像のシナリオでは、必ずしも1枚目ではありません。たとえば、プロンプトが「image2 を修正し、image2 の服を image1 に合わせる」であれば、出力の比率は image2 と一致します。プロンプトで対象が明確でない場合は、モデルが自動で決めます。別のサイズを強制するには、対応する 30 個のサイズのいずれかを選び、小文字の ASCII x を使用してください。例: 2048x13603840x2160。一覧表は 概要ページ を参照してください。
  • quality: ❌ 拒否されます — 指定しないでください
  • n: ❌ 拒否されます — 1回の呼び出しにつき画像 1 枚です。
  • response_format: 省略すると base64 が返ります(raw、プレフィックスなし、2026年7月確認済み)。画像 URL が必要なら "url" を指定してください。URL 出力に依存する事業者は、base64 へのフォールバックなしで決定的に URL を出力するために、token を image2_OSS グループに切り替えるべきです。

コード例

Python

単一画像の編集:
複数画像の融合:

cURL

単一画像の編集:
複数画像の融合:

Node.js (ネイティブ fetch + FormData)

ブラウザー JavaScript (File オブジェクト)

パラメータ

マルチターン反復: 前回の出力を次の呼び出しの image として新しい編集指示とともに渡し、段階的に洗練していきます。各ラウンドではそれぞれ独自の size を指定できます。

応答形式

text-to-image エンドポイントと同様です: 既定で base64 を返しますdata[0].b64_json、プレフィックスなしの生の base64、2026年7月に確認済み)。画像URL を取得するには、response_format: "url" を明示的に指定してください。URL 出力に依存する 事業者は、プレフィックスなしで決定的に URL を出力するよう、トークンを image2_OSS グループ に切り替える必要があります。data[0]url または b64_json のどちらかを返し、両方が返ることはありません。 b64_json モード(既定):
url モードresponse_format: "url" を明示的に指定してください。URL に依存する場合は image2_OSS グループを使用してください):
2026年7月に確認済み: b64_json フィールドは data: プレフィックスなしの生の base64 です — レンダリングする前にデコードするか、自分でプレフィックスを付けてください。以前のバージョンではプレフィックスが含まれていました ので、両方の形式に対応するために最初に必ず startsWith('data:') を確認してください。

関連リソース

モデル概要(フルサイズ表)

30サイズの完全な表、料金、技術仕様

テキストから画像への API

/v1/images/generations互換エンドポイント

姉妹モデル gpt-image-2-all

固定サイズが不要な場合は同じ呼び出し形式で利用でき、出力がより高速です

承認

Authorization
string
header
必須

API Key from the API易 Console

ボディ

multipart/form-data
model
enum<string>
デフォルト:gpt-image-2-vip
必須

Model name, fixed to gpt-image-2-vip

利用可能なオプション:
gpt-image-2-vip
prompt
string
必須

Edit/fusion instruction. For multi-image flows, reference upload order as image1/image2/image3

:

"Place the person from image1 into the scene of image2, in the style of image3"

image
file[]
必須

Reference images. For a single image, send the field once; for multiple images, repeat the same image field (e.g., -F [email protected] -F [email protected]) — upload order maps to image1 / image2 / ... in the prompt. Recommended ≤ 10MB each, formats png / jpg / webp.

size
enum<string>

Output size. For editing, prefer auto (or omit the field) — the model preserves the aspect ratio of whichever reference image the prompt names as the target of the edit (not necessarily the first one in multi-image scenarios). For example, with the prompt "modify image2, change image2's outfit to match image1", the output ratio matches image2. If the prompt doesn't disambiguate, the model decides on its own. To force a different dimension, pick one of the 30 supported sizes; format: WIDTHxHEIGHT with lowercase ASCII x, e.g., 2048x1360, 3840x2160. Flat $0.03/image across all tiers.

利用可能なオプション:
auto,
1280x1280,
848x1280,
1280x848,
960x1280,
1280x960,
1024x1280,
1280x1024,
720x1280,
1280x720,
1280x544,
2048x2048,
1360x2048,
2048x1360,
1536x2048,
2048x1536,
1632x2048,
2048x1632,
1152x2048,
2048x1152,
2048x864,
2880x2880,
2336x3520,
3520x2336,
2480x3312,
3312x2480,
2560x3216,
3216x2560,
2160x3840,
3840x2160,
3840x1632
:

"2048x1360"

レスポンス

Image successfully generated. Defaults to base64 in data[0].b64_jsonurl is not returned in the same response.

Image editing response. Returns base64 by default (data[0].b64_json); to get a url, switch to the image2_OSS group with response_format=url. data[0] returns either url or b64_json, never both.

data
object[]

Result array (this model returns 1 image per call)

created
integer

Unix timestamp (seconds)

usage
object

Token usage statistics