歯ホワイトニング
歯ホワイトニング 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 |
OpenAPI記述をダウンロード
言語
サーバー
https://yce-api-01.makeupar.com