# ヘアカラー

# 概要
ヘアカラーチェンジャーで、幅広いヘアカラーを試せます。スライダーで選択したカラーの濃淡を調整できます。

   * 画像をアップロード

ヘアカラーを変更したい写真をアップロードします。

   * プリセットカラーを選択、またはパターンとパレットでカスタマイズ

 predefined なカラープリセットから選択するか、グラデーション（オンブレ）の適用範囲やブレンドを調整できます。

> **警告:** プリセットとパターン＋パレットの両方が指定されている場合、プリセットが優先されます。

> **警告:** 元の画像には、染めたい髪の領域が含まれている必要があります。適用前に確認してください。これはユーザー側の責任となります。

![](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</br>   - curl >= 7.58 (モダンな TLS/HTTP サポート)</br>   - jq >= 1.6 (堅牢な JSON パーシング) |
| Node.js (JavaScript) | Node >= 18 (グローバル fetch のため) |
| JavaScript | - Chrome / Edge >= 80</br>   - Firefox >= 74</br>   - 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 ユニット <br> オンブレモードで 1 ユニット |

---


License: Privacy policy

## Servers

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

## Security

### BearerAuthenticationV2

[object Object]

Type: http
Scheme: bearer

## Download OpenAPI description

 - [ヘアカラー](https://docs.perfectcorp.com/_bundle/@l10n/ja/reference/ai_hair_color.yaml)

## V1.0

 - [POST /s2s/v2.0/task/hair-color](https://docs.perfectcorp.com/ja/reference/ai_hair_color/v1.0/paths/~1s2s~1v2.0~1task~1hair-color/post.md): このエンドポイントはヘアカラー変更プロセスを開始します。ソースファイル（URL または File ID 経由）を提供し、色設定（プリセット、パターン、またはパレット）を指定する必要があります。タスクは非同期で処理され、このレスポンスで返される task_id を使用してステータスを確認できます。
 - [GET /s2s/v2.0/task/hair-color/{task_id}](https://docs.perfectcorp.com/ja/reference/ai_hair_color/v1.0/paths/~1s2s~1v2.0~1task~1hair-color~1%7Btask_id%7D/get.md)