# 编辑图片（不推荐）

`POST /v1/images/edits`

## 不推荐调用
新接入不要使用本接口。参考图改图、换装、合成或多图创作统一推荐调用 `POST /v1/images/generations/jobs`，并把公网图片 URL 放入 JSON `image` 数组。`gpt-image-2-2K` 和 `gpt-image-2-4K` 不支持本接口。

本接口仅保留给必须使用 OpenAI multipart Images Edits 语义的旧客户端。

## 请求格式
使用 `multipart/form-data`。必须包含 `model`、`prompt` 和至少一张 `image`。

## 图片输入
- 可以传公网可访问的图片 URL，例如 OSS/CDN 地址。
- 大图建议先通过 OSS/CDN 图片处理 resize 到合适分辨率，再提交编辑请求。
- 需要多张网络 URL 做参考图创作、换装、合成或改图时，改用 `/v1/images/generations/jobs` 的 JSON `image` 数组，创建异步任务并轮询结果。

## 参数处理
`prompt`、`size`、`quality`、`background`、`output_format` 和模型扩展字段会随请求提交。多图参考时，在 prompt 中说明每张图片的用途。

## 错误定位
1. 提示 `image is required`：确认请求里包含公网可访问的 `image` URL。
2. 参考图无法读取：确认 URL 未过期、没有鉴权限制，且图片格式可被模型读取。
3. 多图网络 URL 场景结果不符合预期：改用 `/v1/images/generations/jobs` 的 JSON `image` 数组。

Tags: 图片生成