{"templateId":"api_docs","sharedDataIds":{"apiDocsStore":"api-docs-@l10n/zh-TW/reference/ai_teeth_whitening.yaml","sidebar":"sidebar-@l10n/zh-TW/reference/sidebars.yaml"},"props":{"definitionId":"@l10n/zh-TW/reference/ai_teeth_whitening.yaml","settings":{"baseUrlPath":"/zh-tw/reference/ai_teeth_whitening"},"disableAutoScroll":true,"seo":{"title":"AI 牙齒美白","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":"AI 牙齒美白","version":"","description":"# 概述\n**AI 牙齒美白 API**\n\nAI 牙齒美白 API 提供先進的自動化解決方案，用於提升照片中笑容的品質。透過智慧影像處理，它自然且精確地讓牙齒變亮，在數秒內創造精緻、專業的結果。\n\n\n\n\n\n\n**它如何移除照片中的黃牙**\n\n**智慧美白** \nAPI 自動偵測牙齒並套用自然的外觀美白效果，不會讓影像看起來不自然。\n\n**可調整的等級** \n內建的調整功能讓使用者控制美白的程度，從細微的變化到更明顯、適合上鏡的妝效。\n\n\n\n**主要功能**\n\n**快速簡易的增強** \n在數秒內獲得明顯更明亮的笑容。\n\n**精準的 AI 偵測** \n先進的偵測確保只修改牙齒，維持真實且平衡的外觀。\n\n**可調整的美白強度** \n使用者可微調美白強度，以符合他們喜愛的風格。\n\n**以先進演算法達成的自然結果**\n\nAI 牙齒美白 API 使用精密的演算法，精準辨識牙齒並套用栩栩如生的美白效果。使用者可調整強度以達成細微、自然的改善，確保最終結果看起來真實且具視覺吸引力。\n\n---\n\n## 整合指南\n\n* 拍攝自拍\n\n * 在適當光線下正對鏡頭。\n * 使用 JS Camera Kit 拍攝照片。\n\n* 透過 ***/s2s/v2.0/file*** API 取得上傳網址與檔案 ID\n\n 使用檔案 API 回應中回傳的上傳網址，上傳下列檔案：\n * 您的自拍照片\n\n* 執行 AI 任務 ***/s2s/v2.0/task/teeth-whiten***\n\n 使用檔案 ID 或圖片網址作為輸入來源執行 AI 任務。依需求設定特效參數。\n\n* 輪詢任務狀態\n\n 使用回傳的 **task\\_id** 監控任務進度。 \n 輪詢 **GET /s2s/v2.0/task/teeth-whiten/{task_id}** 以查詢引擎狀態。 \n 任務會維持在**「執行中」**狀態，直到完成。任務執行期間不會消耗點數。\n\n\n\n* **使用示範**\n\n\n\n\n\n\n\n## 檔案規格與錯誤\n* 支援的格式與尺寸\n\n|類型|支援的尺寸|支援的檔案大小|支援的格式|\n| ---- | ---- | ---- | ---- |\n|AI 牙齒美白|自拍圖片：
* 長邊 ≤ 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 牙齒美白 V1.0 | 1 |\n\n---\n"},"compilationErrors":[],"markdown":{"partials":{},"variables":{"rbac":{"teams":["anonymous"]},"user":{},"remoteAddr":{"hostname":"docs.perfectcorp.com","port":4000,"ipAddress":"216.73.217.126"},"lang":"zh-TW","env":{"PUBLIC_REDOCLY_BRANCH_NAME":"master"}}},"pagePropGetterError":{"message":"","name":""}},"slug":"/zh-tw/reference/ai_teeth_whitening","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}