Wan 2.1 — 创建任务

POST

/services/aigc/image2image/image-synthesis

curl --location 'https://dashscope.aliyuncs.com/api/v1/services/aigc/image2image/image-synthesis' \
  -H 'X-DashScope-Async: enable' \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "model": "wanx2.1-imageedit",
  "input": {
    "function": "stylization_all",
    "prompt": "转换成法国绘本风格",
    "base_image_url": "http://wanx.alicdn.com/material/20250318/stylization_all_1.jpeg"
  },
  "parameters": {
    "n": 1
  }
}'

{
  "output": {
    "task_status": "PENDING",
    "task_id": "0385dc79-5ff8-4d82-bcb6-xxxxxx"
  },
  "request_id": "4909100c-7b5a-9f92-bfe5-xxxxxx"
}

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

支持 10 种图像编辑功能：

功能	`function` 值	说明
整图风格化	`stylization_all`	整体风格迁移
局部风格化	`stylization_local`	局部风格迁移
指令编辑	`description_edit`	根据文字描述编辑图像
蒙版编辑	`description_edit_with_mask`	结合蒙版的精准编辑
去水印	`remove_watermark`	去除图片水印
扩图	`expand`	向四个方向扩展画布
超分辨率	`super_resolution`	提高图像分辨率
上色	`colorization`	为黑白图片上色
涂鸦成图	`doodle`	基于涂鸦生成图像
卡通特征控制	`control_cartoon_feature`	保持人物特征的卡通化

鉴权

string

header

必填

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

Header 参数

enum<string>

默认值"enable"

必填

启用异步处理，必须设置为 enable。HTTP 请求仅支持异步调用，省略此 Header 会返回错误。

可选值：enable

请求体

application/json

enum<string>

必填

模型名称。

可选值：wanx2.1-imageedit

示例:wanx2.1-imageedit

object

必填

图像编辑的输入数据。

显示子属性

enum<string>

必填

编辑功能类型。

| 值 | 功能 | |---|---| | stylization_all | 整图风格化 | | stylization_local | 局部风格化 | | description_edit | 指令编辑 | | description_edit_with_mask | 蒙版编辑（需要 mask_image_url） | | remove_watermark | 去水印 | | expand | 扩图 | | super_resolution | 超分辨率 | | colorization | 上色 | | doodle | 涂鸦成图 | | control_cartoon_feature | 卡通特征控制 |

可选值：stylization_all,stylization_local,description_edit,description_edit_with_mask,remove_watermark,expand,super_resolution,colorization,doodle,control_cartoon_feature

示例:description_edit_with_mask

string

必填

文本提示词，描述对图像的编辑要求。支持中英文。最大长度：800 字符，超出部分将被截断。

示例:陶瓷兔子拿着陶瓷小花。

取值范围：length <= 800

string

必填

待编辑的原始图像 URL 或 Base64 编码字符串。

图像要求：

支持格式：JPG、JPEG、PNG、BMP、TIFF、WEBP
分辨率：宽高各需在 512~4096 像素之间
最大文件大小：10 MB

支持的输入格式：

公网 URL：支持 HTTP 和 HTTPS
Base64 编码：格式为 data:{MIME_type};base64,{base64_data}

示例:http://wanx.alicdn.com/material/20250318/description_edit_with_mask_3.jpeg

string

蒙版图像 URL 或 Base64 编码字符串。仅当 function 为 description_edit_with_mask 时需要。蒙版图像中白色区域为需要编辑的区域，黑色区域为保留区域。蒙版图像的尺寸应与原始图像一致。

示例:http://wanx.alicdn.com/material/20250318/description_edit_with_mask_3_mask.png

object

控制输出数量、随机种子、水印等处理选项。不同编辑功能支持不同的参数。

显示子属性

integer

默认值1

生成图片的数量。取值范围：1~4，默认值：1。

示例:1

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

integer

随机种子。取值范围：[0, 2147483647]。不设置时算法自动生成。固定种子可复现结果，但由于固有随机性，相同种子不保证完全一致的结果。

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

boolean

默认值false

是否在图片右下角添加固定文字 "AI生成" 水印。默认值：false。

示例:false

number

默认值0.5

图像修改强度。仅适用于 stylization_all 和 description_edit 功能。取值范围：0.0~1.0，默认值：0.5。值越大，生成图像与原图差异越大。

示例:0.5

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

number

默认值1

向上扩展比例。仅适用于 expand 功能。取值范围：1.0~2.0，默认值：1.0。例如 1.5 表示向上扩展原图高度的 50%。

示例:1.5

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

number

默认值1

向下扩展比例。仅适用于 expand 功能。取值范围：1.0~2.0，默认值：1.0。

示例:1.5

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

number

默认值1

向左扩展比例。仅适用于 expand 功能。取值范围：1.0~2.0，默认值：1.0。

示例:1.5

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

number

默认值1

向右扩展比例。仅适用于 expand 功能。取值范围：1.0~2.0，默认值：1.0。

示例:1.5

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

integer

默认值1

超分辨率放大倍数。仅适用于 super_resolution 功能。取值范围：1~4，默认值：1。

示例:2

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

boolean

默认值false

是否为线稿输入。仅适用于 doodle 功能。默认值：false。当为 false 时，模型会先从输入图像中提取线稿；当为 true 时，直接将输入图像作为线稿使用。

示例:false

响应

200-application/json

object

显示子属性

string

任务 ID，可在 24 小时内用于查询任务状态。

enum<string>

任务状态。

可选值：PENDING,RUNNING,SUCCEEDED,FAILED,CANCELED,UNKNOWN

string

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