图片编辑兼容别名
图片编辑的旧路径别名,行为与 /v1/images/edits 一致。
请求格式
使用 multipart/form-data,提交 model、prompt 和公网可访问的图片 URL。
兼容说明
本路径保留给仍调用旧地址的客户端。新接入优先使用异步任务;需要多张网络 URL 做参考图创作、换装、合成或改图时,推荐使用 /v1/images/generations/jobs 的 JSON image 数组。大图建议先通过 OSS/CDN 图片处理 resize 到合适分辨率。
读取结果
响应结构与图片编辑接口一致,可能返回图片 URL 或 base64。前端展示和结果保存逻辑可复用 /v1/images/edits 的处理方式。
Authorizations
在请求头中传入:Authorization: Bearer sk-...
Body
不推荐新接入使用。OpenAI Images Edits 兼容的 multipart 图片编辑请求,仅保留给必须使用 multipart 编辑语义的旧客户端。参考图创作、换装、合成或改图统一推荐使用 /v1/images/generations/jobs 的 JSON image 数组创建异步任务。gpt-image-2-2K 和 gpt-image-2-4K 不支持本接口。
图片编辑模型 ID,例如 qwen-image 或兼容编辑模型。
要编辑的图片 URL。使用 OSS/CDN 等公网可访问地址时,确保 URL 未过期且模型可读取。多图网络 URL 场景推荐改用 /v1/images/generations/jobs 的 JSON image 数组。
编辑指令。说明要保留什么、修改什么、输出风格和限制条件。
遮罩图。透明区域表示允许修改的位置;常见要求为 PNG 格式,并与原图尺寸一致。
输出尺寸。可选值以模型说明为准;不确定尺寸时使用 auto 或模型页列出的尺寸。
"1024x1024"