图像编辑

方法	路径
`POST`	`/v1/images/edits`

该接口使用 multipart/form-data 上传原图和 model 字段。网关会保留原始 body 与 Content-Type 向上游透传，因此调用时应直接使用 POST /v1/images/edits 的 multipart 方式。

bash

curl https://api.modelgo.ai/v1/images/edits \
  -H "Authorization: Bearer $MODELGO_API_KEY" \
  -F "model=<model>" \
  -F "prompt=add a neon background" \
  -F "image=@./cat.png"

如果上游模型不支持图像编辑，平台会返回 provider_unsupported。

响应形态

data[] 的交付形态取决于实际路由到的模型：

gpt-image 系列（gpt-image-2 / gpt-image-2.5-*）：上游不接受 response_format，网关会在转发前剥离该字段且不报错；图像始终以 data[].b64_json 返回，不提供 url 形态。
Qwen Image、Seedream 等其他模型：以各模型官方形态为准，网关不转换。Qwen Image 返回 data[].url（传 b64_json 被忽略）；Seedream 缺省 url，可传 response_format: "b64_json"。完整对照见图像生成。

因此客户端应同时兼容两种形态：

python

item = resp["data"][0]
if item.get("b64_json"):
    image = base64.b64decode(item["b64_json"])
else:
    image = urllib.request.urlopen(item["url"]).read()

size / quality 等取值以实际交付能力为准；不受支持时返回 400，报错信息写明原因。可用取值见 GPT Image。