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

图像生成异步调用2.6

POST/api/v1/image/generation

Header Parameters

Authorization?string

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

X-DashScope-Async?string

异步处理配置参数。wan2.6-t2i异步调用时添加该参数并设置为enable。

Request Body

application/json

model*string

模型名称,固定值:

wan2.6-t2i

Value in"wan2.6-t2i"
input*object

输入的基本信息。

messages*array<object>

请求内容数组。当前仅支持单轮对话,即传入一组role、content参数,不支持多轮对话。

[]?object
role*string

消息的角色。此参数必须设置为user。

text*string

正向提示词,用于描述期望生成的图像内容、风格和构图。

支持中英文,长度不超过2100个字符,每个汉字、字母、数字或符号计为一个字符,超过部分会自动截断。

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

注意:仅支持传入一个text,不传或传入多个将报错。

parameters?object

图像处理参数。

negative_prompt?string

反向提示词,用于描述不希望在图像中出现的内容,对画面进行限制。

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

示例值:低分辨率,低画质,肢体畸形,手指畸形,画面过饱和,蜡像感,人脸无细节,过度光滑,画面具有AI感。构图混乱。文字模糊,扭曲。

size?string

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

默认值为 1280*1280。

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

示例值:1280*1280。

常见比例推荐的分辨率:

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.6-t2i",    "input": {      "messages": [        {          "role": "string",          "text": "string"        }      ]    },    "parameters": {      "negative_prompt": "string",      "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"
}