人像风格重绘 — 创建任务

POST

/services/aigc/image-generation/generation

curl --location 'https://dashscope.aliyuncs.com/api/v1/services/aigc/image-generation/generation' \
  --header 'X-DashScope-Async: enable' \
  --header "Authorization: Bearer $DASHSCOPE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "wanx-style-repaint-v1",
    "input": {
        "image_url": "https://vigen-video.oss-cn-shanghai.aliyuncs.com/demo_image/image_demo_input.png",
        "style_index": 3
    }
}'

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

请先获取 API Key 并设置为环境变量。

将人像照片转换为多种艺术风格，同时保留面部特征和构图。支持预设风格和自定义参考图风格。本 API 仅支持异步调用模式，暂不提供 SDK。

鉴权

string

header

必填

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

Header 参数

enum<string>

默认值"enable"

必填

异步处理配置参数。HTTP请求只支持异步，必须设置为 enable。缺少此请求头将报错："current user api does not support synchronous calls"。

可选值：enable

请求体

application/json

enum<string>

必填

模型名称。示例值：wanx-style-repaint-v1。

可选值：wanx-style-repaint-v1

示例:wanx-style-repaint-v1

object

必填

输入图像的基本信息，比如图像URL地址。

显示子属性

string

必填

输入的图像URL地址。

支持公网可访问的HTTP/HTTPS地址，不包含中文字符。
支持传入Base64编码字符串。
对于本地文件，可通过以下方式获取合法参数值：
- 获取URL：请参见上传文件获取临时URL。
- 生成Base64编码字符串：请参见图像Base64编码传值方式。

图像限制：

图像分辨率：不低于256×256像素，不超过5760×3240像素。
图像格式：JPEG、PNG、JPG、BMP、WEBP。
图像比例：长短边比例不超过2:1。
图像大小：不超过10M。
图像质量：为确保生成质量，请上传脸部清晰照片，人脸比例不宜过小，并避免夸张姿势和表情。

示例:https://vigen-video.oss-cn-shanghai.aliyuncs.com/demo_image/image_demo_input.png

enum<integer>

必填

选择一个预置的风格索引值，即可生成风格化人像。

枚举值：

-1：使用参考图像风格（需提供 style_ref_url）
0：复古漫画
1：3D童话
2：二次元
3：小清新
4：未来科技
5：国画古风
6：将军百战
7：炫彩卡通
8：清雅国风
9：喜迎新年
14：国风工笔
15：恭贺新禧
30：童话世界
31：黏土世界
32：像素世界
33：冒险世界
34：日漫世界
35：3D世界
36：二次元世界
37：手绘世界
38：蜡笔世界
39：冰箱贴世界
40：吧唧世界

可选值：-1,0,1,2,3,4,5,6,7,8,9,14,15,30,31,32,33,34,35,36,37,38,39,40

示例:3

string

风格参考图像URL地址。当 style_index=-1 时必须传入，其他风格无需传入。

支持公网可访问的HTTP/HTTPS地址，不包含中文字符。
支持传入Base64编码字符串。
对于本地文件，可通过以下方式获取合法参数值：
- 获取URL：请参见上传文件获取临时URL。
- 生成Base64编码字符串：请参见图像Base64编码传值方式。

图像限制：

图像分辨率：不低于256×256像素且不超过5760×3240像素。
图像比例：为取得最佳效果，建议图像长短边比例不超过2:1，否则可能影响生成或导致报错。
图像格式：JPEG、PNG、JPG、BMP、WEBP。
图像大小：不超过10M。

示例:https://vigen-video.oss-cn-shanghai.aliyuncs.com/demo_image/style_example.png

响应

200-application/json

object

任务输出信息。

显示子属性

string

任务ID。查询有效期24小时。

enum<string>

任务状态。

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

string

请求唯一标识。可用于请求明细溯源和问题排查。

string

请求失败的错误码。请求成功时不会返回此参数。

string

请求失败的详细信息。请求成功时不会返回此参数。