GPT-IMAGEGPT Image 2
GPT Image 2 · 編輯圖片
圖片 / GPT / GPT Image 2 / 編輯圖片
POST
/v1/images/edits請求參數
Authorization
在 Header 加入參數 Authorization，其值為 Bearer 之後拼接你的 API Key。
Authorization: Bearer ****************
Body 參數multipart/form-data必填
modelstring必需
模型 ID，固定為 `gpt-image-2`
promptstring必需
編輯指令，如把背景改成雪夜
imagefile必需
待編輯圖片；可重複傳多張（`image` 或 `image[]`）
maskfile可選
遮罩圖片，標出要修改的區域
ninteger可選
生成張數，預設 `1`
sizestring可選
解析度，如 `1024x1024`
response_formatstring可選
回傳格式。`url` 僅對支援的模型（如 DALL-E 系列）生效；OpenAI gpt-image 一律回傳 `b64_json` 並忽略此欄位。
範例
{ "model": "gpt-image-2", "prompt": "把背景改成雪夜", "image": "dog.png", "size": "1024x1024"}請求範例程式碼
curl https://api.hotrouter.ai/v1/images/edits \ -H "Authorization: Bearer $API_KEY" \ -F "model=gpt-image-2" \ -F "prompt=把背景改成雪夜" \ -F "image=@dog.png" \ -F "size=1024x1024"回應
200 · 成功
createdinteger可選
建立時間戳（秒）
dataarray[object]必需
生成的圖片列表
範例
{ "created": 1730000000, "data": [ { "b64_json": "<base64>" } ]}