# ヘアカラー

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

ヘアカラーを変更したい写真をアップロードします。
* プリセットカラーを選択、またはパターンとパレットでカスタマイズ

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   - 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

 - [ヘアカラー](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)