Skip to main content
POST
Image editing: edit or fuse reference images with instructions
右側の対話型プレイグラウンドでは、ローカルファイルを直接アップロードできます。Authorization フィールドに API Key を入力し(形式: Bearer sk-xxx)、画像を選択して、promptmodel を入力し、送信をクリックしてください。
適用範囲: このページは、1枚以上の参照画像を編集または融合するためのものです。リクエストは multipart/form-data を使用します。純粋なテキストから画像生成を行う場合は、テキストから画像生成エンドポイント を使用してください。
🖥️ ブラウザー プレイグラウンドの制限(既定の b64_json モード)このエンドポイントは既定で response_format: "b64_json" になるため、応答には数 MB の base64 文字列が含まれ、ブラウザーのプレイグラウンドでは 请求时发生错误: unable to complete request と表示される場合があります — リクエスト自体は実際には成功しています。ブラウザーがそのように長い base64 文字列を描画できないだけです。推奨ワークフロー:
  • プレイグラウンドで画像を見られれば十分ですか? "response_format": "url" を明示的に指定してください — 応答は単一の R2 リンクになり、問題なく表示されます。
  • base64 が必要、または大きな参照画像をアップロードしたいですか? 下のコードサンプルをコピーしてローカルで実行してください — コードがアップロードとデコードを自動で処理します。
📎 複数画像では順序が重要ですimage フィールドは繰り返し指定でき、複数の参照画像をアップロードできます。順序によって、prompt 内の「image1/image2/image3」がどの画像として解釈されるかが決まります。 そのため、次のように明示的に参照することを推奨します。
image1 の人物を image2 のシーンに配置し、image3 の画風を適用する
推奨は画像 1 枚あたり ≤ 10MB、形式は png / jpg / webp です。画像が大きすぎるとゲートウェイの制限に達する場合があります。
🎯 形状を維持する編集: このエンドポイントの出力アスペクト比は、prompt で編集対象として指定された参照画像に従います。複数画像のシナリオでも、必ずしも1枚目とは限りません。たとえば、prompt が “image2 を修正、image2 の服装と帽子を image1 に合わせて変更する” で、image2 が 1:1 の場合、出力も 1:1 になります(image1 が横長の 16:9 でも同様です)。服装の差し替え、アクセサリーの追加、レタッチ、その他の形状を維持する編集に便利です。size フィールドはこのモデルでは効果がありません(どの値を送っても黙って無視されます。サイズを厳密に固定したい場合は、gpt-image-2-vip を使用してください)。prompt が対象を指定しない場合は、モデルが自動で判断します。

コード例

Python

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

cURL

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

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

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

パラメータ早見表

マルチターン反復: 前回の出力画像を image 入力として新しい指示とともに再投入し、結果を反復的に洗練します。

レスポンス形式

text-to-image エンドポイントと同様に、data[0]url または b64_json のどちらかを返し、両方は返しませんresponse_format に依存します)。このエンドポイントは 既定で b64_json です。 b64_json モード(既定):
url モード(明示的な "response_format": "url" が必要です):
2026年7月時点で確認済み: b64_json フィールドは data: プレフィックスのない raw base64 です。レンダリング前にデコードするか、自分でプレフィックスを付けてください。以前のバージョンではプレフィックスが含まれていました ので、両方の形に対応するには最初に startsWith('data:') を必ず確認してください。

承認

Authorization
string
header
必須

API Key from the API易 Console

ボディ

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

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

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

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

:

"Put the person from image1 into the scene of image2, using the art 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.

response_format
enum<string>
デフォルト:b64_json

Response format. b64_json returns a base64 string already prefixed with a data URL header (default); url returns an R2 CDN link

利用可能なオプション:
b64_json,
url

レスポンス

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

Image editing response. data[0] returns either url or b64_json, never both (depends on response_format; this endpoint defaults to b64_json).

data
object[]

Result array (this model returns 1 image per call)

created
integer

Unix timestamp (seconds)

usage
object

Token usage statistics