eae8ea9436
- 新增 alibaba-image provider 支持 qwen-image-edit-plus 系列模型 - 支持 1-6 张图片输出、提示词优化、反向提示词等参数 - 扩展 ImageParamsBar 支持阿里模型专用参数 - 创建通用 ImageGenerationLoading 组件（可配置颜色主题） - 管理后台添加图片生成模型特性配置界面 - 数据库新增 imageGenConfig 字段存储生图特性 - 确保生成图片正确保存到相册和生图记录
356 lines
10 KiB
Markdown
356 lines
10 KiB
Markdown
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 （可选）
|
||
|
||
设置输出图像的分辨率，格式为宽*高，例如"1024*2048"。宽和高的取值范围均为[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：模型的调用信息存在小时级延迟，在模型调用完一小时后，请在模型观测（北京或新加坡）页面，查看调用量、调用次数、成功率等指标。详情请参见如何查看模型调用记录。 |