典名词元典名词元首页
API 文档三方工具教程
AI 模型接口图像万相

图像编辑异步调用2.5

POST/api/v1/image/generation

Header Parameters

Authorization?string

使用 Bearer Token 认证。 格式: Authorization: Bearer sk-xxxxxx

X-DashScope-Async?string

异步处理配置参数。HTTP请求只支持异步,必须设置为enable

Request Body

application/json

model*string

模型名称。固定值:

wan2.5-i2i-preview

Value in"wan2.5-i2i-preview"
input*object

输入的基本信息,如提示词等。

prompt*string

正向提示词,用来描述生成图像中期望包含的元素和视觉特点。

支持中英文,长度不超过2000个字符,每个汉字/字母占一个字符,超过部分会自动截断。

images*array<string>

图像URL数组。输入URL或Base64

数组长度不超过3,即最多输入3张图片。

多图输入时,按照数组顺序定义图像顺序。

图像限制:

图像格式:JPEG、JPG、PNG(不支持透明通道)、BMP、WEBP。

图像分辨率:图像的宽高范围均为[384, 5000]像素。

文件大小:不超过10MB。

[]?string
negative_prompt?string

反向提示词,用来描述不希望在画面中看到的内容,可以对画面进行限制。

支持中英文,长度不超过500个字符,超过部分会自动截断。

示例值:低分辨率、错误、最差质量、低质量、残缺、多余的手指、比例不良等。

parameters?object

图像处理参数。如设置图像分辨率、开启prompt智能改写、添加水印等。

size?string

设置输出图像的分辨率,格式为宽高。默认值为 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 的图像,并按以下规则保持宽高比(近似值):

单图输入:宽高比与输入图像一致;

多图输入:宽高比与最后一张输入图像一致。

n?integer

生成图片的数量。取值范围为1~4张,默认为4。为控制成本,测试建议显式设置为1。

watermark?boolean

是否添加水印标识,水印位于图片右下角,文案固定为“AI生成”。

false:默认值,不添加水印。

true:添加水印。

prompt_extend?boolean

是否开启prompt智能改写。开启后使用大模型对输入prompt进行智能改写,提升综合表现,但会增加耗时。

true:默认值,开启智能改写。

false:不开启智能改写。

seed?integer

随机数种子,取值范围是[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"
}