# AI 虛擬染髮

# 概述
用我們的染髮工具探索多種髮色！嘗試您一直夢寐以求的髮色，並實驗從未試過的新色調。輕鬆用滑桿調整您所選顏色的強度，打造客製化的外觀。
* 上傳您的圖片

上傳您想改變髮色的照片。
* 選擇預設顏色，或以圖樣與調色盤自訂

從預先定義的顏色預設中選擇，或透過調整漸層覆蓋與混合進行微調，創造無限可能！
> **警告：** 若同時指定 preset 與 pattern + palettes，preset 將優先。

> **警告：** 您的來源圖片必須包含要染色的頭髮區域，請在套用前再次確認。請確保來源圖片包含您想染的頭髮區域——正確與否由您負責。

![](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（現代 TLS/HTTP 支援）   - jq >= 1.6（穩健的 JSON 解析） |
| Node.js（JavaScript） | Node >= 18（支援全域 fetch） |
| JavaScript | - Chrome / Edge >= 80   - Firefox >= 74   - Safari >= 13.1 |
| PHP | PHP >= 7.4（現代 TLS/相容性），ext-curl（建議）或 allow_url_fopen=On + ext-openssl、ext-json |
| Python | Python >= 3.10（支援 f-strings），requests >= 2.20.0 |
| Java | Java 11+（支援 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 authentication'。請在標頭中放入您的 'API Key'：`Authorization:Bearer YOUR_API_KEY`。請注意 'Bearer' 與 'YOUR_API_KEY' 之間有一個空格。

Type: http
Scheme: bearer

## Download OpenAPI description

 - [AI 虛擬染髮](https://docs.perfectcorp.com/_bundle/@l10n/zh-TW/reference/ai_hair_color.yaml)

## V1.0

 - [POST /s2s/v2.0/task/hair-color](https://docs.perfectcorp.com/zh-tw/reference/ai_hair_color/v1.0/paths/~1s2s~1v2.0~1task~1hair-color/post.md): 這個端點啟動染髮流程。您必須提供來源檔案（透過網址或檔案 ID），並指定色彩設定（preset、pattern 或 palettes）。任務會以非同步方式處理，您可以使用這個回應回傳的 task_id 查詢其狀態。
 - [GET /s2s/v2.0/task/hair-color/{task_id}](https://docs.perfectcorp.com/zh-tw/reference/ai_hair_color/v1.0/paths/~1s2s~1v2.0~1task~1hair-color~1%7Btask_id%7D/get.md)