Wan v2 — 创建任务

POST

/services/aigc/image-generation/generation

curl --location 'https://dashscope.aliyuncs.com/api/v1/services/aigc/image-generation/generation' \
--header 'Content-Type: application/json' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'X-DashScope-Async: enable' \
--data '{
  "model": "wan2.6-t2i",
  "input": {
    "messages": [
      {
        "role": "user",
        "content": [
          {
            "text": "A flower shop with exquisite windows, a beautiful wooden door, and flowers on display"
          }
        ]
      }
    ]
  },
  "parameters": {
    "prompt_extend": true,
    "watermark": false,
    "n": 1,
    "negative_prompt": "",
    "size": "1280*1280"
  }
}'

{
  "request_id": "<string>",
  "output": {
    "task_id": "<string>",
    "task_status": "PENDING"
  }
}

请先获取 API Key 并设置为环境变量。如需使用 SDK，请先安装 SDK。

支持的模型

Wan 文生图系列各版本使用不同的端点和请求格式：

模型	端点	输入格式	分辨率	最大提示词长度
`wan2.6-t2i`	`/services/aigc/image-generation/generation`	`messages` 数组	12801280 到 14401440，比例 1:4 到 4:1	2,100 字符
`wan2.5-t2i-preview`	`/services/aigc/text2image/image-synthesis`	`prompt` 字符串	12801280 到 14401440，比例 1:4 到 4:1	2,000 字符
`wan2.2-t2i-plus`	`/services/aigc/text2image/image-synthesis`	`prompt` 字符串	每边 512–1440，最大 1440*1440	500 字符
`wan2.2-t2i-flash`	`/services/aigc/text2image/image-synthesis`	`prompt` 字符串	每边 512–1440，最大 1440*1440	500 字符
`wan2.1-t2i-plus`	`/services/aigc/text2image/image-synthesis`	`prompt` 字符串	每边 512–1440，最大 1440*1440	500 字符
`wan2.1-t2i-turbo`	`/services/aigc/text2image/image-synthesis`	`prompt` 字符串	每边 512–1440，最大 1440*1440	500 字符
`wanx2.0-t2i-turbo`	`/services/aigc/text2image/image-synthesis`	`prompt` 字符串	每边 512–1440，最大 1440*1440	800 字符

wan2.6-t2i 还支持同步端点（单次请求，即时响应）。

SDK 版本要求

wan2.6-t2i：DashScope Python SDK 1.25.7+，Java SDK 2.22.6+
wan2.5 及更早版本：DashScope Python SDK 1.25.2+，Java SDK 2.22.2+

鉴权

string

header

必填

千问云 API Key。详见获取 API Key。

Header 参数

enum<string>

必填

必须设置为 enable 以创建异步任务。

可选值：enable

请求体

application/json

object

enum<string>

必填

模型名称。wan2.6-t2i 模型请填写 wan2.6-t2i。

可选值：wan2.6-t2i

示例:wan2.6-t2i

object

必填

包含消息数组的输入对象。

显示子属性

object[]

必填

请求内容数组，仅支持单轮对话（一组 role 和 content）。

显示子属性

enum<string>

必填

消息角色，必须为 user。

可选值：user

object[]

必填

消息内容数组。

显示子属性

string

必填

正向提示词，描述生成图像的内容、风格和构图。支持中英文，最多 2,100 个字符。每次请求只允许一个 text。

示例:A flower shop with exquisite windows, a beautiful wooden door, and flowers on display

object

wan2.6-t2i 模型的参数。

显示子属性

string

可选。描述不希望出现在图像中的内容，最多 500 字符，支持中英文。示例：低分辨率、低质量、肢体变形、手指变形、过度饱和、蜡质感、无面部细节、过度平滑、AI 感、构图混乱、文字模糊、文字扭曲。

string

默认值"1280*1280"

输出图像的分辨率，格式为 宽*高。默认值：1280*1280。总像素数须在 12801280 至 14401440 之间，宽高比须在 1:4 至 4:1 之间。推荐分辨率：1:1（12801280）、3:4（11041472）、4:3（14721104）、9:16（9601696）、16:9（1696*960）。

示例:1280*1280

integer

默认值4

生成图像的数量，取值范围 1 至 4，默认值 4。注意：按图计费（费用 = 单价 × 图像数量），测试时建议设为 1。

取值范围：1 <= x <= 4

boolean

默认值true

是否开启提示词扩写。开启后，系统将使用大模型优化正向提示词，对较短提示词效果提升明显，但会增加几秒处理时间。默认值：true。

boolean

默认值false

是否在图像右下角添加 "AI 生成" 水印。默认值：false。

integer

可选。随机数种子，取值范围 [0, 2147483647]。相同种子可获得更一致的结果，但不保证完全相同。不填时系统随机生成。

取值范围：0 <= x <= 2147483647

响应

200-application/json

string

唯一请求标识符，用于问题排查。

object

显示子属性

string

任务标识符。可通过 GET /tasks/{task_id} 查询任务状态，有效期 24 小时。

enum<string>

任务初始状态，通常为 PENDING。

可选值：PENDING

​支持的模型

​SDK 版本要求

鉴权

Header 参数

请求体

响应

支持的模型

SDK 版本要求