Skip to main content
图片生成与编辑

人像风格重绘

人像风格重绘模型可以将您提供的人物照片,转换为多种预设或自定义的艺术风格。

本文档仅适用于华北2(北京)地域,且必须使用该地域的API Key

模型概览

模型名称

计费单价

限流(主账号与RAM子账号共享)

免费额度(查看)

任务下发接口QPS限制

同时处理中任务数量

wanx-style-repaint-v1

0.12元/张

2

1

500张

快速开始

前提条件

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

示例代码

本模型仅提供 HTTP API,请参考curl示例代码。
  • curl
  • Python
HTTP调用新手指南请参见Postman
由于图像生成耗时较长,API 采用异步模式,调用流程分两步:
步骤1:创建任务获取任务ID
此接口将返回唯一的任务ID(task_id)。请求示例
  • 使用预置风格
  • 使用自定义风格
设置style_index(不能设为-1)。
curl --location 'https://{WorkspaceId}.cn-beijing.maas.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
    }
}'
响应示例task_id查询有效期为24小时。
{
    "output": {
        "task_status": "PENDING",
        "task_id": "0385dc79-5ff8-4d82-bcb6-xxxxxx"
    },
    "request_id": "4909100c-7b5a-9f92-bfe5-xxxxxx"
}
步骤2:查询任务结果
使用 task_id 轮询任务状态,直至完成并获取生成的图像URL。请求示例{task_id}完整替换为上一步接口返回的task_id的值。task_id查询有效期为24小时,并请将{WorkspaceId}替换为真实的业务空间ID
curl -X GET https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/tasks/{task_id} \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"
响应示例
图像URL有效期为24小时,请及时下载图像。
{
    "request_id": "f7fee4f1-1f68-9f17-85df-xxxxx",
    "output": {
        "task_id": "316c7af0-e91f-476f-99bd-xxxxxx",
        "task_status": "SUCCEEDED",
        "submit_time": "2025-08-12 10:55:43.768",
        "scheduled_time": "2025-08-12 10:55:43.799",
        "end_time": "2025-08-12 10:55:48",
        "error_message": "Success",
        "start_time": "2025-08-12 10:55:43",
        "style_index": 0,
        "error_code": 0,
        "results": [
            {
                "url": "http://oss.aliyuncs.com/xxx/abc.jpg"
            }
        ]
    },
    "usage": {
        "image_count": 1
    }
}

输入图像限制

人物图像

  • 图片分辨率:分辨率不小于256*256,不超过5760*3240。长短边比例不超过 2:1。
  • 图片质量:确保生成质量,请上传脸部清晰照片,人脸比例不宜过小,并避免夸张姿势和表情。
  • 图片格式:JPEG,PNG,JPG,BMP,WEBP。
  • 图片大小:不超过10M。
  • 图像URL:
    • 支持公网可访问的 HTTP/HTTPS 地址,URL 中不能包含中文字符;支持传入Base64编码字符串。
    • 对于本地文件,可通过以下两种方式获取合法参数值:

风格参考图

  • 图片分辨率:分辨率不小于256*256,不超过5760*3240。为取得最佳效果,建议图像长短边比例不超过 2:1,否则可能影响生成或导致报错。
  • 图片格式:JPEG,PNG,JPG,BMP,WEBP。
  • 图片大小:不超过10M。
  • 图像URL:
    • 支持公网可访问的 HTTP/HTTPS 地址,URL 中不能包含中文字符;支持传入Base64编码字符串。
    • 对于本地文件,可通过以下两种方式获取合法参数值:

图像Base64编码传值方式

将本地图片文件转换为 Base64 格式的字符串,并按格式拼接:data:{MIME_type};base64,{base64_data}
  • {MIME_type}:图像的媒体类型,需与文件格式对应。
  • {base64_data}:图像文件经过 Base64 编码后的完整数据字符串。
  • 图像格式与MIME 类型对应关系:

    图像格式

    MIME Type

    JPEG

    image/jpeg

    JPG

    image/jpeg

    PNG

    image/png

    BMP

    image/bmp

    WEBP

    image/webp

  • 示例值:"image_url": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAABDg......" 注意:为便于展示,上述 Base64 字符串是截断的。在实际使用中,请务必传入完整的编码字符串。
  • 示例代码:获取图像Base64编码字符串。
import base64
import mimetypes

# ---用于 Base64 编码 ---
# 格式为 data:{MIME_type};base64,{base64_data}
def encode_file(file_path):
    mime_type, _ = mimetypes.guess_type(file_path)
    if not mime_type or not mime_type.startswith("image/"):
        raise ValueError("不支持或无法识别的图像格式")
    with open(file_path, "rb") as image_file:
        encoded_string = base64.b64encode(image_file.read()).decode('utf-8')
    return f"data:{mime_type};base64,{encoded_string}"

if __name__ == "__main__":
    print(encode_file("./image_demo_input.png"))

计费与限流

计费规则
  • 计费项:按成功生成的 图像张数 计费,采用按量后付费模式。
  • 计费公式:费用 = 计费单价 × 图像张数
  • 抵扣顺序:优先消耗免费额度。额度用尽后,默认转为按量付费。
    • 您可开启“免费额度用完即停”功能,以避免免费额度耗尽后产生额外费用。详情请参见免费额度
  • 失败不计费:模型调用失败或处理错误不产生任何费用,也不消耗免费额度。
免费额度 关于免费额度的领取、查询、使用方法等详情,请参见免费额度 调用量查询 模型调用完约一小时后,请在模型观测页面,查看调用量、调用次数、成功率等指标。 限流 模型限流规则及常见问题,请参见限流

API参考

API的输入输出参数,请参见人像风格重绘

常见问题

Q: 如何处理本地图片?
A: 本API支持公网URL,支持 Base64 编码。若要使用本地文件,可通过以下两种方式获取合法参数值:
  1. 获取URL:请将图片上传至对象存储(如阿里云OSS),或使用阿里云百炼提供的临时存储
  2. 生成Base64编码字符串:请参见图像Base64编码传值方式
Q: 如何优化图片生成效果?
A: 好的输入决定了好的输出。请尝试以下方法:
  • 提升人物照片质量:使用高清、光线好、五官清晰无遮挡的正面照。
  • 挑选风格参考图:选择风格鲜明,且匹配人物主题的图片。
Q:预置风格和自定义风格可以同时使用吗?
A:不可以,两者互斥,需选择其中一种模式:
  • 使用预置风格:请设置 style_index(不为-1),枚举值请参见人像风格重绘
  • 使用自定义风格:请提供风格参考图 URL(style_ref_url),并将 style_index设置为 -1。
    若同时传入且未将 style_index 设为 -1,系统可能默认采用预置风格,导致自定义风格不生效。
Q:输出图像的尺寸是否与输入图像一致? A:不一致。 输出图像会保持输入图像的宽高比,但会将短边固定为 1536 像素,长边按比例缩放。
Token Plan
模型体验
模型调优
模型压缩目录节点
用量统计与性能监控
资产中心
服务支持