• 简体中文
  • 图片编辑

    向 /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 令牌:

    Authorization: Bearer sk-你的令牌

    请求体

    字段类型必填说明
    modelstring是图片编辑模型名,如 qwen-image-edit-plus
    imagefile是原图文件,只能以表单文件上传,不支持图片 URL
    promptstring是要做的修改描述,如局部编辑、涂抹修改的内容
    sizestring否输出图片尺寸,如 1024x1024

    请求示例

    cURL
    Python (openai)
    Node.js (openai)
    curl https://api-model.shuntianchuang.cn/v1/images/edits \
      -H "Authorization: Bearer sk-你的令牌" \
      -F model=qwen-image-edit-plus \
      -F image=@origin.webp \
      -F 'prompt=把背景换成星空,其他保持不变' \
      -F size=1024x1024 \
      -o edited.webp

    响应说明

    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,见文生图与图生图。