人像风格重绘模型可以将您提供的人物照片,转换为多种预设或自定义的艺术风格。
模型概览
模型名称 | 计费单价 | 限流(主账号与RAM子账号共享) | 免费额度(查看) | |
|---|---|---|---|---|
任务下发接口QPS限制 | 同时处理中任务数量 | |||
wanx-style-repaint-v1 | 0.12元/张 | 2 | 1 | 500张 |
快速开始
前提条件
您需要已获取与配置 API Key并配置API Key到环境变量。
示例代码
本模型仅提供 HTTP API,请参考curl示例代码。
- curl
- Python
HTTP调用新手指南请参见Postman。
步骤1:创建任务获取任务ID
此接口将返回唯一的任务ID(task_id)。请求示例- 使用预置风格
- 使用自定义风格
设置style_index(不能设为-1)。
task_id查询有效期为24小时。步骤2:查询任务结果
使用task_id 轮询任务状态,直至完成并获取生成的图像URL。请求示例将{task_id}完整替换为上一步接口返回的task_id的值。task_id查询有效期为24小时,并请将{WorkspaceId}替换为真实的业务空间ID。图像URL有效期为24小时,请及时下载图像。
输入图像限制
人物图像
-
图片分辨率:分辨率不小于
256*256,不超过5760*3240。长短边比例不超过 2:1。 - 图片质量:确保生成质量,请上传脸部清晰照片,人脸比例不宜过小,并避免夸张姿势和表情。
- 图片格式:JPEG,PNG,JPG,BMP,WEBP。
- 图片大小:不超过10M。
-
图像URL:
- 支持公网可访问的 HTTP/HTTPS 地址,URL 中不能包含中文字符;支持传入Base64编码字符串。
-
对于本地文件,可通过以下两种方式获取合法参数值:
- 获取URL:请参见上传文件获取临时URL。
- 生成Base64编码字符串:请参见图像Base64编码传值方式。
风格参考图
-
图片分辨率:分辨率不小于
256*256,不超过5760*3240。为取得最佳效果,建议图像长短边比例不超过 2:1,否则可能影响生成或导致报错。 - 图片格式:JPEG,PNG,JPG,BMP,WEBP。
- 图片大小:不超过10M。
-
图像URL:
- 支持公网可访问的 HTTP/HTTPS 地址,URL 中不能包含中文字符;支持传入Base64编码字符串。
-
对于本地文件,可通过以下两种方式获取合法参数值:
- 获取URL:请参见上传文件获取临时URL。
- 生成Base64编码字符串:请参见图像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编码字符串。
计费与限流
计费规则
- 计费项:按成功生成的 图像张数 计费,采用按量后付费模式。
- 计费公式:费用 = 计费单价 × 图像张数。
-
抵扣顺序:优先消耗免费额度。额度用尽后,默认转为按量付费。
- 您可开启“免费额度用完即停”功能,以避免免费额度耗尽后产生额外费用。详情请参见免费额度。
- 失败不计费:模型调用失败或处理错误不产生任何费用,也不消耗免费额度。
API参考
API的输入输出参数,请参见人像风格重绘。
常见问题
Q: 如何处理本地图片?
A: 本API支持公网URL,支持 Base64 编码。若要使用本地文件,可通过以下两种方式获取合法参数值:- 获取URL:请将图片上传至对象存储(如阿里云OSS),或使用阿里云百炼提供的临时存储。
- 生成Base64编码字符串:请参见图像Base64编码传值方式。
Q: 如何优化图片生成效果?
A: 好的输入决定了好的输出。请尝试以下方法:- 提升人物照片质量:使用高清、光线好、五官清晰无遮挡的正面照。
- 挑选风格参考图:选择风格鲜明,且匹配人物主题的图片。
Q:预置风格和自定义风格可以同时使用吗?
A:不可以,两者互斥,需选择其中一种模式:- 使用预置风格:请设置 style_index(不为-1),枚举值请参见人像风格重绘。
-
使用自定义风格:请提供风格参考图 URL(style_ref_url),并将 style_index设置为 -1。
若同时传入且未将 style_index 设为 -1,系统可能默认采用预置风格,导致自定义风格不生效。