典名词元典名词元首页
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-t2i-preview

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

输入的基本信息。

prompt*string

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

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

示例值:一只坐着的橘黄色的猫,表情愉悦,活泼可爱,逼真准确。

negative_prompt*string

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

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

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

parameters?object

图像处理参数。

size?string

输出图像的分辨率,格式为宽*高。

默认值为 1280*1280。

总像素在 [12801280, 14401440] 之间且宽高比范围为 [1:4, 4:1]。例如,768*2700符合要求。

示例值:1280*1280。

以下分辨率适用于wan2.5-t2i-preview:

1:1:1280*1280

3:4:1104*1472

4:3:1472*1104

9:16:960*1696

16:9:1696*960

1:1:1280*1280

3:4:1104*1472

4:3:1472*1104

9:16:960*1696

16:9:1696*960

n?integer

生成图片的数量。取值范围为1~4张,默认为4。

注意:按张计费,测试建议设为 1。

prompt_extend?boolean

是否开启提示词智能改写。开启后,将使用大模型优化正向提示词,对较短的提示词有明显提升效果,但增加3-4秒耗时。

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

false:关闭智能改写。

watermark?boolean

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

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

true:添加水印。

seed?integer

随机数种子,取值范围[0,2147483647]。

使用相同的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-t2i-preview",    "input": {      "prompt": "string",      "negative_prompt": "string"    },    "parameters": {      "size": "string",      "n": 0,      "prompt_extend": true,      "watermark": 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"
}