# 歯ホワイトニング # 概要 **歯ホワイトニング API** 歯ホワイトニング API で、写真内の歯を明るくします。 ![](https://plugins-media.makeupar.com/smb/blog/post/2023-07-28/f05fda4d-8ca8-4661-b4b5-135067280a10.jpg) **写真内の黄ばんだ歯を除去する方法** **スマートホワイトニング** 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”** 状態のままです。タスク実行中はユニットは消費されません。 * **使用例のデモ** ![](https://plugins-media.makeupar.com/smb/blog/post/2022-05-13/26c04462-d183-4392-937b-f6173ff9e814.jpg) ![](https://plugins-media.makeupar.com/smb/blog/post/2025-07-01/webp_a4cd3779-2966-4b8f-888e-032dffc003c0.webp) ![](https://plugins-media.makeupar.com/smb/blog/post/2025-11-13/webp_5824c85f-813e-4c14-b036-38cba206ee0b.webp) ## ファイル仕様とエラー * 対応フォーマットと寸法 | タイプ | 対応寸法 | 対応ファイルサイズ | 対応フォーマット | | --- | --- | --- | --- | | 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 標準の '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_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 統合ガイド](/develop/ - [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)