AI 助理
备案控制台
文档
输入文档关键字查找
首页 大模型服务平台百炼 开发参考 模型调用 图像编辑与生成 人像风格重绘API参考

人像风格重绘API参考

更新时间：
产品详情
我的收藏

本文介绍人像风格重绘模型的输入输出参数。人像风格重绘是根据用户提供原始图片，再选择自己想要的风格，就可以生成其他不同类型的图像。

相关指南：人像风格重绘

模型概览

模型名

模型简介

免费额度

计费单价

限流（含主账号与RAM子账号）

任务下发接口QPS限制

同时处理中任务数量

wanx-style-repaint-v1

通义万相-人像风格重绘可以将输入的人物图像进行多种风格化的重绘生成，使新生成的图像在兼顾原始人物相貌的同时，带来不同风格的绘画效果。

免费额度：500张

领取方式：开通阿里云百炼大模型服务后，自动发放

有效期：180天

0.12元/张

2

1

前提条件

您需要已获取API Key并配置API Key到环境变量。

HTTP调用

创建任务

POST https://dashscope.aliyuncs.com/api/v1/services/aigc/image-generation/generation

请求头（Headers）

使用预置风格模板

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://public-vigen-video.oss-cn-shanghai.aliyuncs.com/public/dashscope/test.png",
        "style_index": 3
    }
}'

上传参考风格图像

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://public-vigen-video.oss-cn-shanghai.aliyuncs.com/public/dashscope/test.png",
        "style_index": -1,
        "style_ref_url": "https://vigen-video.oss-cn-shanghai.aliyuncs.com/VideoGeneration/Data/cosplay%E8%A7%92%E8%89%B2%E5%BA%93/%E6%96%B0%E7%89%88%E9%9D%A2%E5%BD%A2%E8%B1%A1%E5%BA%93/ACG%E9%A3%8E%E6%A0%BC%EF%BC%88%E7%94%B7%EF%BC%89/65ba3ee96b1b868dfad0cf96c52c86112e035bb893329b8dda2a90b8a38485e0.png"
    }
}'

Content-Type string 必选

请求内容类型。固定为application/json。

Authorization string 必选

推荐您使用百炼API-Key，也可填DashScope API-Key。例如：Bearer d1xxx2a。

X-DashScope-Async string 必选

是否开启异步处理。必须开启异步处理，设置为enable。

请求体（Request Body）

model string 必选

调用模型。

input object 必选

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

属性

image_url string 必选

输入的图像URL地址。

图像限制：

  • 图像格式：图片格式：JPEG、PNG、JPG、BMP、WEBP。

  • 图像分辨率：不低于256×256像素，小于5760×3240像素。

  • 图像比例：宽高比例不超过1.5:1，若超过1.5:1将自动裁剪到1.5:1,宽是指水平方向的边，高是指垂直方向的边。

  • 图像质量：为确保生成质量，请上传脸部清晰照片，人脸比例不宜过小，并避免夸张姿势和表情。

  • 图片大小：不超过10M。

  • URL地址中不能包含中文字符。

style_index integer 必选

人像风格类型索引值。

枚举值

  • -1：参考上传图像风格

  • 0：复古漫画

  • 1：3D童话

  • 2：二次元

  • 3：小清新

  • 4：未来科技

  • 5：国画古风

  • 6：将军百战

  • 7：炫彩卡通

  • 8：清雅国风

  • 9：喜迎新年

style_ref_url string 可选

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

图像限制：

  • 图片分辨率：不小于256×256像素且不超过5760×3240像素。

  • 图像比例：宽高比不超过2:1，宽是指水平方向的边，高是指垂直方向的边。

  • 图片格式：JPEG、PNG、JPG、BMP、WEBP。

  • 图片大小：不超过10M。

  • URL地址中不能包含中文字符。

响应

成功响应

{
    "output": {
        "task_id": "xxxxxxxx",
        "task_status": "PENDING"
    },
    "request_id": "7574ee8f-38a3-4b1e-9280-11c33ab46e51"
}

异常响应

{
    "code":"InvalidApiKey",
    "message":"Invalid API-key provided.",
    "request_id":"fb53c4ec-1c12-4fc4-a580-cdb7c3261fc1"
}

output object

任务输出信息。

属性

task_id string

任务id。

task_status string

任务状态。

  • PENDING：排队中

  • RUNNING：处理中

  • SUSPENDED：挂起

  • SUCCEEDED：执行成功

  • FAILED：执行失败

  • UNKNOWN：任务不存在或状态未知

code string

请求失败，表示错误码，成功时返回参数中不会包含该参数。

message string

请求失败，表示失败详细信息，成功时返回参数中不会包含该参数。

request_id string

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

根据任务ID查询结果

GET https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}

请求头（Headers）

获取任务结果

curl -X GET \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
https://dashscope.aliyuncs.com/api/v1/tasks/{your-task-id}

Authorization string 必选

API-KEY，例如：Bearer d1**2a。

URL路径参数（Path parameters）

task_id string 必选

任务id，任务唯一标识。

响应

任务执行成功

对于本模型，任务状态和结果将保留24小时，生成图像的URL地址有效期也为24小时，需要您在有效期内及时转存生成图像，24小时之后，任务连同结果一起从系统中清除。

{
    "request_id": "<your request id>",
    "output": {
        "task_id": "<your task id>",
        "task_status": "SUCCEEDED",
        "submit_time": "xxx",
        "scheduled_time": "xxx",
        "end_time": "xxx",
        "error_message": "Success",
        "start_time": "xxx",
        "style_index": 0,
        "error_code": 0,
        "results": [
            {
                "url": "http://oss.aliyuncs.com/xxx/abc.jpg"
            }
        ]
    },
    "usage": {
        "image_count": 1
    }
}

任务执行失败

{
  "request_id": "<your request id>",
  "output": {
    "task_id": "<your task id>",
    "task_status": "FAILED",
    "submit_time": "xxx",
    "scheduled_time": "xxx",
    "end_time": "xxx",
    "code": "InvalidImageResolution",
    "message": "The input image resolution is too large or small"
  },
  "usage": {
    "image_num": 0
  }
}

任务执行中

{
    "request_id":"e5d70b02-ebd3-98ce-9fe8-759d7d7b107d",
    "output":{
        "task_id":"86ecf553-d340-4e21-af6e-a0c6a421c010",
        "task_status":"RUNNING",
        "task_metrics":{
            "TOTAL":1,
            "SUCCEEDED":1,
            "FAILED":0
        }
    }
}

output dict

调用结果信息，对于千问模型，包含输出text。

属性

task_id string

任务id。

task_status string

任务状态。

  • PENDING：排队中

  • RUNNING：处理中

  • SUSPENDED：挂起

  • SUCCEEDED：执行成功

  • FAILED：执行失败

  • UNKNOWN：任务不存在或状态未知

task_metrics object

每个任务结果统计。

属性

TOTAL integer

总的任务数。

SUCCEEDED integer

任务状态为成功的任务数。

FAILED integer

任务状态为失败的任务数。

code string

请求失败，表示错误码，成功时返回参数中不会返回该参数。

message string

请求失败，表示失败详细信息，成功时返回参数中不会包含该参数。

results list

生成结果，每个元素为生成图片的URL。

request_id string

本次请求的系统唯一码。

usage dict

输出信息统计。

属性

image_count integer

本次请求成功生成的图片数量。

错误码

如果模型调用失败并返回报错信息，请参见错误码进行解决。

此API还有特定状态码，具体如下所示。

HTTP状态码

接口错误码（code）

接口错误信息（message）

含义说明

400

InvalidURL

The request URL is invalid, make sure the url is correct and is an image

输入URL错误，请确保URL链接的正确性

400

InvalidImageResolution

The input image resolution is too large or small

输入图像分辨率过大或过小

上一篇：Cosplay动漫人物生成API参考下一篇：虚拟模特API参考
文档推荐