简体中文

English

简体中文

English

主题

Qwen 图像编辑 ​

图像编辑与文生图共用模型家族，入口为编辑路由，支持 JSON 多模态请求与 文件上传两种提交方式。

http
POST /v1/images/edits

当前可用模型 ​

请求头 ​

名称类型必填说明
string是请求身份认证。使用 Bearer Token，示例：
string否请求内容类型。JSON 请求体时必须设置为 ； 由客户端自动携带（如 curl 使用 时），无需手动设置

请求体 ​

名称类型必填说明
string是固定传 或
object否原生多模态输入结构，包含 （消息只传一条； 固定 ； 传 1～3 个 和一个 ）
object否Qwen 图片生成参数（ 原生格式 、、、、）。显式传入后，适配器直接使用其中的参数
string否multipart 格式使用的编辑要求
file | string否multipart 格式的参考图文件，可以重复传递多个
integer否multipart 格式的输出数量。未传或为 时按 处理
boolean否multipart 格式的水印开关

input.messages.content 内容项 ​

名称类型必填说明
string否文本内容，即编辑要求
string否参考图地址，支持 HTTP/HTTPS URL 或带 MIME 前缀的 Data URL。格式支持 JPG、JPEG、PNG、BMP、TIFF、WEBP、GIF；官方建议宽高在 384～2048 像素之间；单张不超过 10 MB

parameters ​

名称类型必填说明
string否输出尺寸，原生格式为 （例如 ）
integer否输出图片数量；上游当前取值范围为 1～6。未传或为 时按 处理
boolean否是否添加水印
boolean否是否开启提示词扩写
integer否随机种子

multipart 文件上传 ​

multipart 请求使用 提交以下字段：、、一个或多个 、、。

多文件可以重复传递 字段：

bash
--form 'image=@/absolute/path/reference-1.png' \
--form 'image=@/absolute/path/reference-2.png'

请求示例 ​

bash
curl --request POST https://octopusx.ai/v1/images/edits \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "qwen-image-3.0-pro",
  "input": {
    "messages": [
      {
        "role": "user",
        "content": [
          { "image": "https://example.com/reference.png" },
          { "text": "保留人物面部特征，将服装改成都市职业风格" }
        ]
      }
    ]
  },
  "parameters": {
    "prompt_extend": true,
    "size": "1080*1080",
    "n": 1,
    "watermark": false
  }
}'
bash
curl --request POST https://octopusx.ai/v1/images/edits \
  --header 'Authorization: Bearer <token>' \
  --form 'model=qwen-image-3.0-pro' \
  --form 'prompt=保留人物面部特征，将服装改成都市职业风格' \
  --form 'image=@/absolute/path/reference.png' \
  --form 'n=1' \
  --form 'watermark=false'
json
{
  "model": "qwen-image-3.0-pro",
  "input": {
    "messages": [
      {
        "role": "user",
        "content": [
          { "image": "https://example.com/person.png" },
          { "image": "https://example.com/style.png" },
          { "text": "保留第一张图的人物，采用第二张图的绘画风格" }
        ]
      }
    ]
  },
  "parameters": {
    "size": "1024*1536",
    "n": 1
  }
}
json
{
  "image": "data:image/png;base64,iVBORw0KGgoAAA..."
}

响应示例 ​

json
{
  "created": 1788188983,
  "data": [
    {
      "url": "https://example.com/generated.png"
    }
  ],
  "metadata": {
    "output": {
      "choices": [
        {
          "finish_reason": "stop",
          "message": {
            "role": "assistant",
            "content": [
              {
                "type": "image",
                "image": "https://example.com/generated.png"
              }
            ]
          }
        }
      ]
    },
    "request_id": "example-request-id",
    "usage": {
      "input_image_count": 1,
      "input_image_type": "qima_input_1k",
      "output_image_count": 1,
      "output_image_type": "qima_output_1k",
      "output_width": 1080,
      "output_height": 1080
    }
  }
}

响应字段 ​

图生图/编辑与文生图共用同一套响应结构。created、data（含 url、revised_prompt）、metadata（含 output、request_id、usage）与错误对象 error（message、type、param、code）的字段定义、错误码含义及排查方式，详见 Qwen 图像生成 · 响应字段。

与文生图的唯一差异： 反映本次实际传入的参考图数量（文生图恒为 ）。

注意事项 ​

WARNING

multipart 路径不会构造完整的 Qwen 图片参数。需要控制 、 或 时，应使用 JSON 多模态请求。

相关接口 ​