{"templateId":"api_docs","sharedDataIds":{"apiDocsStore":"api-docs-@l10n/ja/reference/ai_teeth_whitening.yaml","sidebar":"sidebar-@l10n/ja/reference/sidebars.yaml"},"props":{"definitionId":"@l10n/ja/reference/ai_teeth_whitening.yaml","settings":{"baseUrlPath":"/ja/reference/ai_teeth_whitening"},"disableAutoScroll":true,"seo":{"title":"歯ホワイトニング","description":"YouCam API documentation by Perfect Corp. Learn how to use Skin analysis API, Virtual try-on API, Image editing API, and Video generative AI APIs.","siteUrl":"https://docs.perfectcorp.com","keywords":"AI Skin Analysis, AI Clothes, AI Hairstyle, AI Outfits","image":"/assets/favicon.cd6fa4d833b2a573b3c6dae68386b293da205b203402cb0c97b80bd2acc07ea2.8351e24f.png"},"dynamicMarkdocComponents":[],"metadata":{"type":"openapi","title":"歯ホワイトニング","version":"","description":"# 概要\n**歯ホワイトニング API**\n\n歯ホワイトニング API で、写真内の歯を明るくします。\n\n\n\n\n\n\n**写真内の黄ばんだ歯を除去する方法**\n\n**スマートホワイトニング** \nAPI は自動的に歯を検出し、ホワイトニング効果を適用します。\n\n**調整可能なレベル** \nホワイトニングの度合いを調整できます。\n\n\n\n\n**主な機能**\n\n**迅速な強化** \n数秒で歯を明るくします。\n\n**正確な AI 検出** \n歯のみが修正されます。\n\n**調整可能なホワイトニング強度** \nホワイトニングの強度を調整できます。\n\n**自然な結果**\n\n歯ホワイトニング API は、歯を識別してホワイトニング効果を適用します。強度を調整できます。\n\n---\n\n## 統合ガイド\n\n* セルフィーを撮影する\n\n * 適切な照明の下でカメラに直接向かいます。\n * JS Camera Kit を使用して写真をキャプチャします。\n\n* ***/s2s/v2.0/file*** API を介してアップロード URL とファイル ID を取得する\n\n ファイル API レスポンスで返されたアップロード URL を使用して、以下のファイルをアップロードします。\n * セルフィー写真\n\n* AI タスク ***/s2s/v2.0/task/teeth-whiten*** を実行する\n\n 入力ソースとしてファイル ID または画像 URL を使用して AI タスクを実行します。効果パラメータを必要に応じて設定します。\n\n* タスクステータスのポーリング\n\n 返された **task\\_id** を使用してタスクの進捗を監視します。 \n **GET /s2s/v2.0/task/teeth-whiten/{task_id}** をポーリングしてエンジンのステータスを確認します。 \n タスクは完了するまで **“running”** 状態のままです。タスク実行中はユニットは消費されません。\n\n\n\n* **使用例のデモ**\n\n\n\n\n\n\n\n## ファイル仕様とエラー\n* 対応フォーマットと寸法\n\n|タイプ|対応寸法|対応ファイルサイズ|対応フォーマット|\n| ---- | ---- | ---- | ---- |\n|AI Teeth Whitening|セルフィー画像:
* 長辺 ≤ 1920 px
* 短辺 ≥ 320 px |< 10MB|jpg/png|\n\n\n* エラーコード\n\n|エラーコード|説明|\n| ---- | ---- |\n| error_exceed_max_image_size | 画像の長辺が 1920 ピクセルを超える場合 |\n|error_below_min_image_size|画像の幅または高さが 320 ピクセル未満の場合、使用するには小さすぎます|\n|error_face_position_invalid|画像内で顔全体が完全に可視であり、一部が切り取られていない必要があります|\n|error_face_position_too_small|写真内の顔が小さすぎて適切に分析できません|\n|error_face_position_out_of_boundary|顔が大きすぎるか、写真の端の一部が外れています|\n|error_insufficient_lighting|照明が暗すぎて分析が困難です|\n|error_face_angle_invalid|顔の角度が適切ではありません。正面を向いた撮影では、頭を正面から 10 度以内に保ってください。横を向いた撮影では、角度は 15 度以上である必要があります|\n\n* 環境と依存関係\n\n| サンプルコード言語 / ツール | 推奨ランタイムバージョン |\n|---|---|\n| cURL | - bash >= 3.2 - curl >= 7.58 (モダンな TLS/HTTP サポート) - jq >= 1.6 (堅牢な JSON パーシング) |\n| Node.js (JavaScript) | Node >= 18 (グローバル fetch 用) |\n| JavaScript | - Chrome / Edge >= 80 - Firefox >= 74 - Safari >= 13.1 |\n| PHP | PHP >= 7.4 (モダンな TLS/互換性用), ext-curl (推奨) または allow_url_fopen=On + ext-openssl, ext-json |\n| Python | Python >= 3.10 (f-strings 用), requests >= 2.20.0 |\n| Java | Java 11+ (HttpClient 用), Jackson Databind >= 2.12.0 |\n\n---\n\n## ユニット消費量\n\n| AI 機能 | 消費ユニット |\n|---|---|\n| AI Teeth Whitening V1.0 | 1 |\n\n---\n"},"compilationErrors":[],"markdown":{"partials":{},"variables":{"rbac":{"teams":["anonymous"]},"user":{},"remoteAddr":{"hostname":"docs.perfectcorp.com","port":4000,"ipAddress":"216.73.216.56"},"lang":"ja","env":{"PUBLIC_REDOCLY_BRANCH_NAME":"master"}}},"pagePropGetterError":{"message":"","name":""}},"slug":"/ja/reference/ai_teeth_whitening","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}