图像编辑异步调用2.5
/api/v1/image/generationHeader Parameters
使用 Bearer Token 认证。 格式: Authorization: Bearer sk-xxxxxx
异步处理配置参数。HTTP请求只支持异步,必须设置为enable
Request Body
application/json
模型名称。固定值:
wan2.5-i2i-preview
"wan2.5-i2i-preview"输入的基本信息,如提示词等。
正向提示词,用来描述生成图像中期望包含的元素和视觉特点。
支持中英文,长度不超过2000个字符,每个汉字/字母占一个字符,超过部分会自动截断。
图像URL数组。输入URL或Base64
数组长度不超过3,即最多输入3张图片。
多图输入时,按照数组顺序定义图像顺序。
图像限制:
图像格式:JPEG、JPG、PNG(不支持透明通道)、BMP、WEBP。
图像分辨率:图像的宽高范围均为[384, 5000]像素。
文件大小:不超过10MB。
反向提示词,用来描述不希望在画面中看到的内容,可以对画面进行限制。
支持中英文,长度不超过500个字符,超过部分会自动截断。
示例值:低分辨率、错误、最差质量、低质量、残缺、多余的手指、比例不良等。
图像处理参数。如设置图像分辨率、开启prompt智能改写、添加水印等。
设置输出图像的分辨率,格式为宽高。默认值为 12801280。
图像分辨率:总像素在 [768768, 12801280] 之间,且宽高比范围为 [1:4, 4:1]。 示例值:1280*1280。
推荐分辨率及对应宽高比:
1280*1280:1:1
1024*1024:1:1
800*1200:2:3
1200*800:3:2
960*1280:3:4
1280*960:4:3
720*1280:9:16
1280*720:16:9
1344*576:21:9
若未指定size,系统将默认生成总像素为 1280*1280 的图像,并按以下规则保持宽高比(近似值):
单图输入:宽高比与输入图像一致;
多图输入:宽高比与最后一张输入图像一致。
生成图片的数量。取值范围为1~4张,默认为4。为控制成本,测试建议显式设置为1。
是否添加水印标识,水印位于图片右下角,文案固定为“AI生成”。
false:默认值,不添加水印。
true:添加水印。
是否开启prompt智能改写。开启后使用大模型对输入prompt进行智能改写,提升综合表现,但会增加耗时。
true:默认值,开启智能改写。
false:不开启智能改写。
随机数种子,取值范围是[0, 2147483647]。
如果不提供,则算法自动生成一个随机数作为种子。如果提供,则根据n的值分别为n张图片生成seed参数,例如n=4,算法将分别生成seed、seed+1、seed+2、seed+3作为参数的图片。
若需提升生成结果的可复现性,建议固定seed值。
请注意,由于模型生成具有概率性,即使使用相同 seed,也不能保证每次生成结果完全一致。
Response Body
application/json
curl -X POST "https://api.aa.com.cn/api/v1/image/generation" \ -H "Authorization: string" \ -H "X-DashScope-Async: string" \ -H "Content-Type: application/json" \ -d '{ "model": "wan2.5-i2i-preview", "input": { "prompt": "string", "images": [ "string" ], "negative_prompt": "string" }, "parameters": { "size": "string", "n": 0, "watermark": true, "prompt_extend": true, "seed": 0 } }'{
"code": 0,
"data": {
"urls": [
"string"
],
"usage": {
"images": 0,
"seconds": 0,
"input_tokens": 0,
"total_tokens": 0,
"output_tokens": 0
},
"expired": "string",
"task_id": "string",
"task_status": "string"
},
"message": "string",
"request_id": "string"
}