1. 概述
使用当前 API Key 已开通的万相图片编辑模型编辑图片。
baseUrl:https://token.soar.qjclouds.cn/laserEr/00000000/v1completionsPath:/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 格式。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | 是 | 模型编码,以当前 API Key 实际开通的万相图片编辑模型为准。 |
input | object | 是 | 模型输入信息。 |
input.messages | array<object> | 是 | 消息列表;仅支持单轮对话,必须且只能包含一个消息对象。 |
input.messages[].role | string | 是 | 消息角色,固定为 user。 |
input.messages[].content | array<object> | 是 | 消息内容列表,可包含图片和文本内容。 |
input.messages[].content[].image | string | 是 | 待编辑图片;支持公网 HTTP/HTTPS URL 或原厂协议支持的 Base64 Data URL。 |
input.messages[].content[].text | string | 是 | 图片编辑指令,描述期望的修改效果。 |
parameters | object | 否 | 图片编辑参数。 |
parameters.size | string | 否 | 输出分辨率;示例为 2K,实际可选值以所选模型能力为准。 |
parameters.n | integer | 否 | 生成图片数量,默认 1;具体上限由所选模型决定。 |
parameters.watermark | boolean | 否 | 是否在图片右下角添加“AI Generated”水印;默认 false。 |
parameters.thinking_mode | boolean | 否 | 是否开启思考模式;示例为 true,支持情况以所选模型为准。 |
4. 请求示例
JSON
{
"model": "wan2.7-image-pro-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": {
"size": "2K",
"n": 1,
"watermark": false,
"thinking_mode": true
}
}5. 响应示例
JSON
{
"output": {
"choices": [
{
"message": {
"role": "assistant",
"content": [
{
"image": "https://dashscope-7c2c.oss-accelerate.aliyuncs.com/1d/0a/20260910/727717a8/dd45fb34-163a-4c16-9194-d7a2d3376402_0.png?Expires=1789119649&OSSAccessKeyId=LTAI5tPxpiCM2hjmWrFXrym1&Signature=QQ4HhldPNAYsC%2FsP9BWmQrpSbKA%3D",
"type": "image"
}
]
},
"finish_reason": "stop"
}
],
"finished": true
},
"usage": {
"size": "2048*2048",
"image_count": 1,
"input_tokens": 9577,
"output_tokens": 2,
"total_tokens": 9579
},
"request_id": "2a70dc10-fcbb-49c7-a20d-bcd0a54b6a34"
}响应图片 URL 通常具有有效期,请及时下载或转存。