eae8ea9436
- 新增 alibaba-image provider 支持 qwen-image-edit-plus 系列模型 - 支持 1-6 张图片输出、提示词优化、反向提示词等参数 - 扩展 ImageParamsBar 支持阿里模型专用参数 - 创建通用 ImageGenerationLoading 组件（可配置颜色主题） - 管理后台添加图片生成模型特性配置界面 - 数据库新增 imageGenConfig 字段存储生图特性 - 确保生成图片正确保存到相册和生图记录
10 KiB
qwen-image-edit-plus推荐
当前与qwen-image-edit-plus-2025-10-30能力相同 qwen-image-edit-plus系列模型，支持单图编辑和多图融合。
可输出 1-6 张图片。
支持自定义分辨率。
支持提示词智能优化。
格式：PNG 分辨率：
可指定：通过 parameters.size 参数指定输出图像的宽*高（单位：像素）。
默认（不指定时）：总像素接近 1024*1024，宽高比与输入图（多图输入时为最后一张）一致。
qwen-image-edit-plus-2025-12-15 推荐
qwen-image-edit-plus-2025-10-30 推荐
qwen-image-edit
支持单图编辑和多图融合。
仅支持输出 1 张图片。
不支持自定义分辨率。
格式：PNG
分辨率：不可指定。生成规则同上方的默认规则。
HTTP调用 在调用前，您需要获取与配置 API Key，再配置API Key到环境变量。
如需通过SDK进行调用，请安装DashScope SDK。目前，该SDK已支持Python和Java。
重要 北京和新加坡地域拥有独立的 API Key 与请求地址，不可混用，跨地域调用将导致鉴权失败或服务报错。
北京地域：POST https://dashscope.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation
请求参数
单图编辑
curl --location 'https://dashscope.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation'
--header 'Content-Type: application/json'
--header "Authorization: Bearer $DASHSCOPE_API_KEY"
--data '{
"model": "qwen-image-edit-plus",
"input": {
"messages": [
{
"role": "user",
"content": [
{
"image": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/fpakfo/image36.webp"
},
{
"text": "生成一张符合深度图的图像，遵循以下描述：一辆红色的破旧的自行车停在一条泥泞的小路上，背景是茂密的原始森林"
}
]
}
]
},
"parameters": {
"n": 2,
"negative_prompt": "低质量",
"prompt_extend": true,
"watermark": false
}
}'
多图融合
curl --location 'https://dashscope.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation'
--header 'Content-Type: application/json'
--header "Authorization: Bearer $DASHSCOPE_API_KEY"
--data '{
"model": "qwen-image-edit-plus",
"input": {
"messages": [
{
"role": "user",
"content": [
{
"image": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/thtclx/input1.png"
},
{
"image": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/iclsnx/input2.png"
},
{
"image": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/gborgw/input3.png"
},
{
"text": "图1中的女生穿着图2中的黑色裙子按图3的姿势坐下"
}
]
}
]
},
"parameters": {
"n": 2,
"negative_prompt": "低质量",
"prompt_extend": true,
"watermark": false
}
}'
请求头（Headers） Content-Type string （必选）
请求内容类型。此参数必须设置为application/json。
Authorization string（必选）
请求身份认证。接口使用阿里云百炼API-Key进行身份认证。示例值：Bearer sk-xxxx。
请求体（Request Body） model string （必选）
模型名称，可选以下模型：
qwen-image-edit-plus系列模型：包括 qwen-image-edit-plus、qwen-image-edit-plus-2025-12-15、qwen-image-edit-plus-2025-10-30，支持输出1-6张图片。
qwen-image-edit：仅支持输出1张图片。
input object （必选）
输入参数对象，包含以下字段：
属性
messages array （必选）
请求内容数组。当前仅支持单轮对话，因此数组内有且只有一个对象，该对象包含role和content两个属性。
属性
role string （必选）
消息发送者角色，必须设置为user。
content array （必选）
消息内容，包含1-3张图像，格式为 {"image": "..."}；以及单个编辑指令，格式为 {"text": "..."}。
属性
image string （必选）
输入图像的 URL 或 Base64 编码数据。支持传入1-3张图像。
多图输入时，按照数组顺序定义图像顺序，输出图像的比例以最后一张为准。
图像要求：
图像格式：JPG、JPEG、PNG、BMP、TIFF、WEBP和GIF。
输出图像为PNG格式，对于GIF动图，仅处理其第一帧。 图像分辨率：为获得最佳效果，建议图像的宽和高均在384像素至3072像素之间。分辨率过低可能导致生成效果模糊，过高则会增加处理时长。
图像大小：不超过10MB。
支持的输入格式：
公网可访问的URL
支持 HTTP 或 HTTPS 协议。本地文件请参见上传文件获取临时 URL。
示例值：https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/fpakfo/image36.webp
传入 Base64 编码图像后的字符串
示例值：data:image/jpeg;base64,GDU7MtCZz...（示例已截断，仅做演示）
Base64 编码规范请参见通过Base64编码传入图片。
text string （必选）
图像编辑指令，即正向提示词，用来描述生成图像中期望包含的元素和视觉特点。
进行多图像编辑时，编辑指令中需要使用“图1”、“图2”、“图3”等描述来指代相应的图片，否则会出现不符合预期的编辑结果。
支持中英文，长度上限800个字符，每个汉字/字母占一个字符，超过部分会自动截断。
示例值：图1中的女生穿着图2中的黑色裙子按图3的姿势坐下，保持其服装、发型和表情不变，动作自然流畅。
parameters object （可选）
控制图像生成的附加参数。
属性
n integer （可选）
输出图像的数量，默认值为1。
对于qwen-image-edit-plus系列模型，可选择输出1-6张图片。
对于qwen-image-edit，仅支持输出1张图片。
negative_prompt string （可选）
反向提示词，用来描述不希望在画面中看到的内容，可以对画面进行限制。
支持中英文，长度上限500个字符，每个汉字/字母占一个字符，超过部分会自动截断。
示例值：低分辨率、错误、最差质量、低质量、残缺、多余的手指、比例不良等。
size string （可选）
设置输出图像的分辨率，格式为宽高，例如"10242048"。宽和高的取值范围均为[512, 2048]像素。
默认行为：若不设置，输出图像将保持与输入图像（多图输入时为最后一张）相似的长宽比，接近1024*1024分辨率。
支持模型：仅qwen-image-edit-plus系列模型支持。
prompt_extend bool （可选）
是否开启prompt智能改写。开启后，将使用大模型优化正向提示词，对描述性不足、较为简单的prompt提升效果较明显。
true：默认值，开启智能改写。
false：不开启智能改写。
支持模型：仅qwen-image-edit-plus系列模型支持。
watermark bool （可选）
是否在图像右下角添加 "Qwen-Image" 水印。默认值为 false。水印样式如下：
1
seed integer （可选）
随机数种子，取值范围[0,2147483647]。
使用相同的seed参数值可使生成内容保持相对稳定。若不提供，算法将自动使用随机数种子。
注意：模型生成过程具有概率性，即使使用相同的seed，也不能保证每次生成结果完全一致。
响应参数 任务执行成功 { "output": { "choices": [ { "finish_reason": "stop", "message": { "role": "assistant", "content": [ { "image": "https://dashscope-result-sz.oss-cn-shenzhen.aliyuncs.com/xxx.png?Expires=xxx" }, { "image": "https://dashscope-result-sz.oss-cn-shenzhen.aliyuncs.com/xxx.png?Expires=xxx" } ] } } ] }, "usage": { "width": 1248, "image_count": 2, "height": 832 }, "request_id": "bf37ca26-0abe-98e4-8065-xxxxxx" }
任务执行异常 { "request_id": "31f808fd-8eef-9004-xxxxx", "code": "InvalidApiKey", "message": "Invalid API-key provided." } output object
包含模型生成结果。
属性
choices array
结果选项列表。
属性
finish_reason string
任务停止原因，自然停止时为stop。
message object
模型返回的消息。
属性
role string
消息的角色，固定为assistant。
content array
消息内容，包含生成的图像信息。
属性
image string
生成图像的 URL，格式为PNG。链接有效期为24小时，请及时下载并保存图像。
usage object
本次调用的资源使用情况，仅调用成功时返回。
属性
image_count integer
生成的图像数量，等于选择输出图片的数量。
width integer
生成图像的宽度（像素）。
height integer
生成图像的高度（像素）。
request_id string
请求唯一标识。可用于请求明细溯源和问题排查。
code string
请求失败的错误码。请求成功时不会返回此参数，详情请参见错误信息。
message string
请求失败的详细信息。请求成功时不会返回此参数，详情请参见错误信息。
常见问题 Q：qwen-image-edit 支持多轮对话式编辑吗？ A：不支持。模型仅支持单轮执行。每次调用均为独立、无状态的任务。如需连续编辑，须将生成的图片作为新输入再次调用。
Q：qwen-image-edit 和 qwen-image-edit-plus 系列模型支持哪些语言？ A：目前正式支持简体中文和英文；其他语言可自行尝试，但效果未经充分验证，可能存在不确定性。
Q：上传多张不同比例的参考图时，输出图像的比例以哪张为准？ A：输出图像会以最后一张上传的参考图的比例为准。
Q：如何查看模型调用量？ A：模型的调用信息存在小时级延迟，在模型调用完一小时后，请在模型观测（北京或新加坡）页面，查看调用量、调用次数、成功率等指标。详情请参见如何查看模型调用记录。