# 歯ホワイトニング
# 概要
**歯ホワイトニング API**
歯ホワイトニング API で、写真内の歯を明るくします。
**写真内の黄ばんだ歯を除去する方法**
**スマートホワイトニング**
API は自動的に歯を検出し、ホワイトニング効果を適用します。
**調整可能なレベル**
ホワイトニングの度合いを調整できます。
**主な機能**
**迅速な強化**
数秒で歯を明るくします。
**正確な AI 検出**
歯のみが修正されます。
**調整可能なホワイトニング強度**
ホワイトニングの強度を調整できます。
**自然な結果**
歯ホワイトニング API は、歯を識別してホワイトニング効果を適用します。強度を調整できます。
---
## 統合ガイド
* セルフィーを撮影する
* 適切な照明の下でカメラに直接向かいます。
* JS Camera Kit を使用して写真をキャプチャします。
* ***/s2s/v2.0/file*** API を介してアップロード URL とファイル ID を取得する
ファイル API レスポンスで返されたアップロード URL を使用して、以下のファイルをアップロードします。
* セルフィー写真
* AI タスク ***/s2s/v2.0/task/teeth-whiten*** を実行する
入力ソースとしてファイル ID または画像 URL を使用して AI タスクを実行します。効果パラメータを必要に応じて設定します。
* タスクステータスのポーリング
返された **task\_id** を使用してタスクの進捗を監視します。
**GET /s2s/v2.0/task/teeth-whiten/{task_id}** をポーリングしてエンジンのステータスを確認します。
タスクは完了するまで **“running”** 状態のままです。タスク実行中はユニットは消費されません。
* **使用例のデモ**
## ファイル仕様とエラー
* 対応フォーマットと寸法
|タイプ|対応寸法|対応ファイルサイズ|対応フォーマット|
| ---- | ---- | ---- | ---- |
|AI Teeth Whitening|セルフィー画像:
* 長辺 ≤ 1920 px
* 短辺 ≥ 320 px |< 10MB|jpg/png|
* エラーコード
|エラーコード|説明|
| ---- | ---- |
| error_exceed_max_image_size | 画像の長辺が 1920 ピクセルを超える場合 |
|error_below_min_image_size|画像の幅または高さが 320 ピクセル未満の場合、使用するには小さすぎます|
|error_face_position_invalid|画像内で顔全体が完全に可視であり、一部が切り取られていない必要があります|
|error_face_position_too_small|写真内の顔が小さすぎて適切に分析できません|
|error_face_position_out_of_boundary|顔が大きすぎるか、写真の端の一部が外れています|
|error_insufficient_lighting|照明が暗すぎて分析が困難です|
|error_face_angle_invalid|顔の角度が適切ではありません。正面を向いた撮影では、頭を正面から 10 度以内に保ってください。横を向いた撮影では、角度は 15 度以上である必要があります|
* 環境と依存関係
| サンプルコード言語 / ツール | 推奨ランタイムバージョン |
|---|---|
| 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 Teeth Whitening V1.0 | 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_teeth_whitening.yaml)
## V1.0
- [POST /s2s/v2.0/task/teeth-whiten/pre-process](https://docs.perfectcorp.com/ja/reference/ai_teeth_whitening/v1.0/paths/~1s2s~1v2.0~1task~1teeth-whiten~1pre-process/post.md): ソース画像に複数の有効なターゲットが含まれる可能性がある場合、またはエフェクトを適用する検出ターゲットを明示的に選びたい場合は、前処理タスクを使います。単一ターゲットの画像では、機能がデフォルトの `index` 値をサポートしているため、手動でのターゲット選択が不要な場合は前処理をスキップできます。 前処理タスクは、ソース画像内の候補ターゲットを検出し、その座標を `data.results.r
- [GET /s2s/v2.0/task/teeth-whiten/pre-process/{task_id}](https://docs.perfectcorp.com/ja/reference/ai_teeth_whitening/v1.0/paths/~1s2s~1v2.0~1task~1teeth-whiten~1pre-process~1%7Btask_id%7D/get.md)
- [POST /s2s/v2.0/task/teeth-whiten](https://docs.perfectcorp.com/ja/reference/ai_teeth_whitening/v1.0/paths/~1s2s~1v2.0~1task~1teeth-whiten/post.md): AI タスクは非同期です。機能ごとに Webhook がサポートされている場合は、Webhook による完了処理を優先します。Webhook エンドポイントを設定し、Webhook 署名を検証したうえで、`success` または `error` の通知が来たら、受け取った `task_id` を使ってタスクの結果を照会します。設定と検証の詳細は [Webhook 統合ガイド](../develo
- [GET /s2s/v2.0/task/teeth-whiten/{task_id}](https://docs.perfectcorp.com/ja/reference/ai_teeth_whitening/v1.0/paths/~1s2s~1v2.0~1task~1teeth-whiten~1%7Btask_id%7D/get.md)