图片编辑
向 /v1/images/edits 上传原图,结合提示词对图片做局部编辑、涂抹修改。可用模型与价格以 模型广场 为准(找名称带 edit 的图片模型),下文以 qwen-image-edit-plus 为例。
WARNING
重要区分,先确认你该用哪个接口:
/v1/images/edits:局部图片编辑、蒙版涂抹。强制multipart/form-data,不支持application/json,不支持传入图片 HTTP 链接 URL,图片必须以文件表单上传。/v1/images/generations:文生图、整体图生图重绘。支持 JSON 请求体,可直接传入图片公网 URL。如果你的需求是整张图片整体重绘、图生图,不需要局部蒙版涂抹,请使用该接口,见文生图与图生图。
端点
POST /v1/images/edits
认证
请求头携带 Bearer 令牌:
请求体
请求示例
响应说明
NOTE
接口为 multipart/form-data,禁止使用 JSON Body,图片参数必须上传本地文件,不支持直接填写图片 https 链接。用 Apifox 调试时请将 Body 切换为 form-data,image 字段类型选择 File 上传文件。
响应有可能直接返回二进制图片内容而非 JSON(cURL 示例中的 -o 参数用于直接保存图片到本地),请以响应头 Content-Type 判断返回类型。
常见报错 convert_request_failed: image is required 代表请求格式错误,一般是误用 JSON 传图片 URL 导致,请切换为表单文件上传;整体图生图请改用 /v1/images/generations,见文生图与图生图。
