千问图片编辑

千问 Image 2.0 图片编辑

1. 概述

使用当前 API Key 已开通的千问图片编辑模型编辑图片。

  • baseUrl：https://token.soar.qjclouds.cn/laserEr/00000000/v1
  • completionsPath：/image/generations/{apiType}
  • apiType：ImageEdit
  • 标准地址：POST {baseUrl}{completionsPath}
  • 鉴权：Authorization: Bearer <api_key>

请求地址：https://token.soar.qjclouds.cn/laserEr/00000000/v1/image/generations/ImageEdit

2. 鉴权

Header必填说明
Authorization是Bearer <api_key>
Content-Type是application/json

3. 请求体

请求体采用阿里云原厂 API JSON 格式。

参数类型必填说明
modelstring是模型编码，以当前 API Key 实际开通的千问图片编辑模型为准。
inputobject是模型输入信息。
input.messagesarray<object>是消息列表；仅支持单轮对话，必须且只能包含一个消息对象。
input.messages[].rolestring是消息角色，固定为 user。
input.messages[].contentarray<object>是消息内容列表，可包含图片和文本内容。
input.messages[].content[].imagestring是待编辑图片；支持公网 HTTP/HTTPS URL 或原厂协议支持的 Base64 Data URL。
input.messages[].content[].textstring是图片编辑指令，描述期望的修改效果。
parametersobject否图片编辑参数。
parameters.negative_promptstring否反向提示词，描述不希望出现的内容；支持中英文，最长 500 个字符，超出部分自动截断。
parameters.prompt_extendboolean否是否启用提示词智能改写；默认 true，仅优化正向提示词。
parameters.watermarkboolean否是否在图片右下角添加水印；默认 false。
parameters.sizestring否输出分辨率，格式为 宽*高；具体范围由所选模型决定。
parameters.ninteger否生成图片数量，默认 1；具体上限由所选模型决定。
parameters.seedinteger否随机数种子，范围 0–2147483647；相同种子可提高结果稳定性，但不保证完全一致。

4. 请求示例

JSON
{
    "model": "qwen-image-2.0-cn",
    "input": {
        "messages": [
            {
                "role": "user",
                "content": [
                    {
                        "image": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260310/jiydyi/image+%2818%29-2026-03-10-16-39-59.webp"
                    },
                    {
                        "text": "在画面右下角石板路旁、靠近树干根部的位置，以浅灰墨色手写体题写一首七言绝句，字体为行楷风格，笔触自然流畅、略带飞白，大小适中（约占画面高度1/10），与整体水墨淡雅氛围协调。诗文内容为：“青石桥畔柳风轻， 素手拈花闭目听。 一水碧痕浮旧梦， 半篙烟雨入空舲。”诗句横向排列，四句分两行书写（前两句一行，后两句一行），末句“舲”字右下角钤一枚朱红小印，印文为“江南”二字篆书，尺寸约等于单字高度的1/3。"
                    }
                ]
            }
        ]
    },
    "parameters": {
        "n": 1,
        "negative_prompt": " ",
        "prompt_extend": true,
        "watermark": false,
        "size": "2048*2048"
    }
}

5. 响应示例

JSON
{
    "output": {
        "choices": [
            {
                "message": {
                    "role": "assistant",
                    "content": [
                        {
                            "image": "https://dashscope-0484.oss-accelerate.aliyuncs.com/7d/25/20260910/8500b3f9/c101315c-4997-4b74-9cb3-31af806eb2b9.png?Expires=1789638176&OSSAccessKeyId=LTAI5tPxpiCM2hjmWrFXrym1&Signature=FcNx%2BfAWlg%2F2I2W6U4OunLYXRuY%3D"
                        }
                    ]
                },
                "finish_reason": "stop"
            }
        ]
    },
    "usage": {
        "image_count": 1
    },
    "request_id": "e77373ca-0e17-4b3b-a299-42f5b9b4cad5"
}

响应图片 URL 通常具有有效期，请及时下载或转存。