请求参数 | 全局风格化 局部风格化 局部重绘 去水印 扩图 图像超分 图像上色 线稿生图 垫图
curl --location 'https://dashscope.aliyuncs.com/api/v1/services/aigc/image2image/image-synthesis' \
--header 'X-DashScope-Async: enable' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"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
}
}'
curl --location 'https://dashscope.aliyuncs.com/api/v1/services/aigc/image2image/image-synthesis' \
--header 'X-DashScope-Async: enable' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "wanx2.1-imageedit",
"input": {
"function": "stylization_local",
"prompt": "把房子变成木板风格。",
"base_image_url": "http://wanx.alicdn.com/material/20250318/stylization_local_1.png"
},
"parameters": {
"n": 1
}
}'
curl --location 'https://dashscope.aliyuncs.com/api/v1/services/aigc/image2image/image-synthesis' \
--header 'X-DashScope-Async: enable' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "wanx2.1-imageedit",
"input": {
"function": "description_edit_with_mask",
"prompt": "陶瓷兔子拿着陶瓷小花。",
"base_image_url": "http://wanx.alicdn.com/material/20250318/description_edit_with_mask_3.jpeg",
"mask_image_url": "http://wanx.alicdn.com/material/20250318/description_edit_with_mask_3_mask.png"
},
"parameters": {
"n": 1
}
}'
curl --location 'https://dashscope.aliyuncs.com/api/v1/services/aigc/image2image/image-synthesis' \
--header 'X-DashScope-Async: enable' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "wanx2.1-imageedit",
"input": {
"function": "remove_watermark",
"prompt": "去除图像中的文字",
"base_image_url": "http://wanx.alicdn.com/material/20250318/remove_watermark_1.png"
},
"parameters": {
"n": 1
}
}'
curl --location 'https://dashscope.aliyuncs.com/api/v1/services/aigc/image2image/image-synthesis' \
--header 'X-DashScope-Async: enable' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "wanx2.1-imageedit",
"input": {
"function": "expand",
"prompt": "一位绿色仙子",
"base_image_url": "http://wanx.alicdn.com/material/20250318/expand_2.jpg"
},
"parameters": {
"top_scale": 1.5,
"bottom_scale": 1.5,
"left_scale": 1.5,
"right_scale": 1.5,
"n": 1
}
}'
curl --location 'https://dashscope.aliyuncs.com/api/v1/services/aigc/image2image/image-synthesis' \
--header 'X-DashScope-Async: enable' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "wanx2.1-imageedit",
"input": {
"function": "super_resolution",
"prompt": "图像超分。",
"base_image_url": "http://wanx.alicdn.com/material/20250318/super_resolution_1.jpeg"
},
"parameters": {
"upscale_factor": 2,
"n": 1
}
}'
curl --location 'https://dashscope.aliyuncs.com/api/v1/services/aigc/image2image/image-synthesis' \
--header 'X-DashScope-Async: enable' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "wanx2.1-imageedit",
"input": {
"function": "colorization",
"prompt": "蓝色背景，黄色的叶子。",
"base_image_url": "http://wanx.alicdn.com/material/20250318/colorization_1.jpeg"
},
"parameters": {
"n": 1
}
}'
curl --location 'https://dashscope.aliyuncs.com/api/v1/services/aigc/image2image/image-synthesis' \
--header 'X-DashScope-Async: enable' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "wanx2.1-imageedit",
"input": {
"function": "doodle",
"prompt": "北欧极简风格的客厅。",
"base_image_url": "http://wanx.alicdn.com/material/20250318/doodle_1.png"
},
"parameters": {
"n": 1
}
}'
curl --location 'https://dashscope.aliyuncs.com/api/v1/services/aigc/image2image/image-synthesis' \
--header 'X-DashScope-Async: enable' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "wanx2.1-imageedit",
"input": {
"function": "control_cartoon_feature",
"prompt": "卡通形象小心翼翼地探出头，窥视着房间内一颗璀璨的蓝色宝石。",
"base_image_url": "http://wanx.alicdn.com/material/20250318/control_cartoon_feature_1.png"
},
"parameters": {
"n": 1
}
}'
|
请求头（Headers） |
Content-Type string （必选） 请求内容类型。此参数必须设置为application/json。 |
Authorization string（必选） 请求身份认证。接口使用百炼API-Key进行身份认证。示例值：Bearer d1xxx2a。 |
X-DashScope-Async string （必选） 异步处理配置参数。HTTP请求只支持异步，必须设置为enable。 |
请求体（Request Body） |
model string （必选） 模型名称。示例值：wanx2.1-imageedit。 |
input object （必选） 输入的基本信息，如提示词等。
prompt string （必选） 提示词，用来描述生成图像中期望包含的元素和视觉特点。 支持中英文，长度不超过800个字符，每个汉字/字母占一个字符，超过部分会自动截断。 不同功能的提示词存在差异，建议根据具体功能参考相应的技巧说明。 function string （必选） 图像编辑功能。目前支持的功能有： stylization_all：全局风格化，当前支持2种风格。风格和提示词技巧 stylization_local：局部风格化，当前支持8种风格。风格和提示词技巧 description_edit_with_mask：局部重绘。提示词技巧 remove_watermark：去文字水印。提示词技巧 expand：扩图。提示词技巧 super_resolution：图像超分。提示词技巧 colorization：图像上色。提示词技巧 doodle：线稿生图。提示词技巧 control_cartoon_feature：垫图，当前仅支持卡通形象。提示词技巧
base_image_url string （必选） 输入图像的URL地址。 图像限制： mask_image_url string （可选） 仅当function设置为description_edit_with_mask（局部重绘）时必填，其余情况无需填写。 涂抹区域图像要求： 数据格式 ：仅支持图像URL地址，不支持Base64数据。 图像分辨率 ：必须与base_image_url的图像分辨率保持一致。图像宽度和高度需在[512, 4096]像素之间。 图像格式 ：支持JPG、JPEG、PNG、BMP、TIFF、WEBP。 图像大小 ：不超过10MB。 URL地址中不能包含中文字符。
涂抹区域颜色要求： 白色区域 ：表示需要编辑的部分，必须使用纯白色（RGB值为[255,255,255]），否则可能无法正确识别。 黑色区域：表示无需改变的部分，必须使用纯黑色（RGB值为[0,0,0]），否则可能无法正确识别。
关于如何获取涂抹区域图像：使用PS抠图或其他工具生成黑白涂抹图像。
|
parameters object （可选） 图像处理参数。
n integer （可选） 生成图片的数量。取值范围为1~4张，默认为1。 seed integer （可选） 随机数种子，用于控制模型生成内容的随机性。seed参数取值范围是[0, 2147483647]。 如果不提供，则算法自动生成一个随机数作为种子。如果您希望生成内容保持相对稳定，请使用相同的seed参数值。 watermark bool （可选） 是否添加水印标识，水印位于图片右下角，文案为“AI生成”。 false：默认值，不添加水印。 true：添加水印。
n integer （可选） 生成图片的数量。取值范围为1~4张，默认为1。 seed integer （可选） 随机数种子，用于控制模型生成内容的随机性。seed参数取值范围是[0, 2147483647]。 如果不提供，则算法自动生成一个随机数作为种子。如果您希望生成内容保持相对稳定，请使用相同的seed参数值。 watermark bool （可选） 是否添加水印标识，水印位于图片右下角，文案为“AI生成”。 false：默认值，不添加水印。 true：添加水印。
top_scale float （可选） 当function设置为expand（扩图）时才需填写。 图像居中，向上按比例扩展图像。默认值为1.0，取值范围[1.0, 2.0]。 bottom_scale float （可选） 当function设置为expand（扩图）时才需填写。 图像居中，向下按比例扩展图像。默认值为1.0，取值范围[1.0, 2.0]。 left_scale float （可选） 当function设置为expand（扩图）时才需填写。 图像居中，向左按比例扩展图像。默认值为1.0，取值范围[1.0, 2.0]。 right_scale float （可选） 当function设置为expand（扩图）时才需填写。 图像居中，向右按比例扩展图像。默认值为1.0，取值范围[1.0, 2.0]。 n integer （可选） 生成图片的数量。取值范围为1~4张，默认为1。 seed integer （可选） 随机数种子，用于控制模型生成内容的随机性。seed参数取值范围是[0, 2147483647]。 如果不提供，则算法自动生成一个随机数作为种子。如果您希望生成内容保持相对稳定，请使用相同的seed参数值。 watermark bool （可选） 是否添加水印标识，水印位于图片右下角，文案为“AI生成”。 false：默认值，不添加水印。 true：添加水印。
upscale_factor integer （可选） 当function设置为super_resolution（图像超分）时才需填写。 图像超分的放大倍数。在放大图像的同时增强细节，提升图像分辨率，实现高清处理。 取值范围为1~4，默认值为1。当upscale_factor设置为1时，仅对图像进行高清处理，不进行放大。
|
