# AI 发色虚拟试染

# 概览
用 AI 发色虚拟试染玩遍各种发色！一直想试的发色尽管试，没试过的新鲜色号也能玩。拉一拉滑杆就能调整所选颜色的浓淡，做出专属您的效果。
* 上传图片

上传您要改发色的照片。
* 选预设色，或按图案与配色自行调配

从预设色里挑，也能微调渐变（ombre）的覆盖范围与融合度，玩法无穷！
> **警告：** 若同时指定了预设色与图案 + 配色，以预设色优先。

> **警告：** 源图必须包含您要染的头发区域，套用前请再确认一次。源图里没带上想染的头发区域，后果需由您自行承担。

![](https://bcw-media.s3.ap-northeast-1.amazonaws.com/hair_color_s2_poster_dt_v2_49198cabc0.png)
![](https://bcw-media.s3.ap-northeast-1.amazonaws.com/01_1_1_8365c3b503.jpg)
![](https://bcw-media.s3.ap-northeast-1.amazonaws.com/01_2_1_abfcdb7eba.jpg)
## 文件规格与错误码
* 支持的格式与尺寸

| AI 功能 | 支持尺寸 | 支持文件大小 | 支持格式 |
|  --- | --- | --- | --- |
| AI 发色虚拟试染 | 长边 < 1920，脸宽 >= 100 | < 10MB | jpg/jpeg/png |

* 错误码

| 错误码 | 说明 |
|  --- | --- |
| error_below_min_image_size | 源图尺寸小于下限（要求：宽 >= 320px，高 >= 320px） |
| error_exceed_max_image_size | 源图尺寸超过上限（要求：宽 < 1920px，高 < 1080px） |

* 运行环境与依赖

| 示例代码语言 / 工具 | 建议运行时版本 |
|  --- | --- |
| cURL | - bash >= 3.2   - curl >= 7.58 (modern TLS/HTTP support)   - jq >= 1.6 (robust JSON parsing) |
| Node.js (JavaScript) | Node >= 18 (for global fetch) |
| JavaScript | - Chrome / Edge >= 80   - Firefox >= 74   - Safari >= 13.1 |
| PHP | PHP >= 7.4 (for modern TLS/compat), ext-curl (recommended) or allow_url_fopen=On + ext-openssl, ext-json |
| Python | Python >= 3.10 (for f-strings), requests >= 2.20.0 |
| Java | Java 11+ (for HttpClient), Jackson Databind >= 2.12.0 |



---

## 点数消耗
| AI 功能 | 消耗点数 |
|  --- | --- |
| AI 发色虚拟试染虚拟试戴 V1.0 | 全头模式 1 点数  渐变模式 1 点数 |



---

License: Privacy policy

## Servers

```
https://yce-api-01.makeupar.com
```

## Security

### BearerAuthenticationV2

使用标准的 Bearer 鉴权。把您的 API 密钥放进请求头： `Authorization:Bearer YOUR_API_KEY`。请注意 'Bearer' 与 'YOUR_API_KEY' 之间有一个空格。

Type: http
Scheme: bearer

## Download OpenAPI description

 - [AI 发色虚拟试染](https://docs.perfectcorp.com/_bundle/@l10n/zh-CN/reference/ai_hair_color.yaml)

## V1.0

 - [POST /s2s/v2.0/task/hair-color](https://docs.perfectcorp.com/zh-cn/reference/ai_hair_color/v1.0/paths/~1s2s~1v2.0~1task~1hair-color/post.md): 本接口用于发起 AI 发色虚拟试染流程。您需要提供源文件（URL 或文件 ID），并指定上色方式（预设 preset、图案 pattern 或色板 palettes）。任务会异步处理，您可以使用本响应返回的 task_id 查询其状态。
 - [GET /s2s/v2.0/task/hair-color/{task_id}](https://docs.perfectcorp.com/zh-cn/reference/ai_hair_color/v1.0/paths/~1s2s~1v2.0~1task~1hair-color~1%7Btask_id%7D/get.md)