# AI 牙齒美白 # 概述 **AI 牙齒美白 API** AI 牙齒美白 API 提供先進的自動化解決方案，用於提升照片中笑容的品質。透過智慧影像處理，它自然且精確地讓牙齒變亮，在數秒內創造精緻、專業的結果。 ![](https://plugins-media.makeupar.com/smb/blog/post/2023-07-28/f05fda4d-8ca8-4661-b4b5-135067280a10.jpg) **它如何移除照片中的黃牙** **智慧美白** API 自動偵測牙齒並套用自然的外觀美白效果，不會讓影像看起來不自然。 **可調整的等級** 內建的調整功能讓使用者控制美白的程度，從細微的變化到更明顯、適合上鏡的妝效。 **主要功能** **快速簡易的增強** 在數秒內獲得明顯更明亮的笑容。 **精準的 AI 偵測** 先進的偵測確保只修改牙齒，維持真實且平衡的外觀。 **可調整的美白強度** 使用者可微調美白強度，以符合他們喜愛的風格。 **以先進演算法達成的自然結果** AI 牙齒美白 API 使用精密的演算法，精準辨識牙齒並套用栩栩如生的美白效果。使用者可調整強度以達成細微、自然的改善，確保最終結果看起來真實且具視覺吸引力。 --- ## 整合指南 * 拍攝自拍 * 在適當光線下正對鏡頭。 * 使用 JS Camera Kit 拍攝照片。 * 透過 ***/s2s/v2.0/file*** API 取得上傳網址與檔案 ID 使用檔案 API 回應中回傳的上傳網址，上傳下列檔案： * 您的自拍照片 * 執行 AI 任務 ***/s2s/v2.0/task/teeth-whiten*** 使用檔案 ID 或圖片網址作為輸入來源執行 AI 任務。依需求設定特效參數。 * 輪詢任務狀態 使用回傳的 **task_id** 監控任務進度。 輪詢 **GET /s2s/v2.0/task/teeth-whiten/{task_id}** 以查詢引擎狀態。 任務會維持在**「執行中」**狀態，直到完成。任務執行期間不會消耗點數。 * **使用示範** ![](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 牙齒美白 | 自拍圖片： * 長邊 ≤ 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 牙齒美白 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 - [AI 牙齒美白](https://docs.perfectcorp.com/_bundle/@l10n/zh-TW/reference/ai_teeth_whitening.yaml) ## V1.0 - [POST /s2s/v2.0/task/teeth-whiten/pre-process](https://docs.perfectcorp.com/zh-tw/reference/ai_teeth_whitening/v1.0/paths/~1s2s~1v2.0~1task~1teeth-whiten~1pre-process/post.md): 當來源照片可能包含超過一個有效目標，或您的整合需要明確選擇哪個被偵測到的目標接受特效時，請使用前處理任務。對於單一目標的圖片，當功能支援預設的 `index` 值，且您的應用程式不需要手動選擇目標時，可以跳過前處理。 前處理任務會偵測來源照片中的候選目標，並在 `data.results.result` 中回傳它們的座標。結果陣列中的每個項目代表一個被偵測到的目標。檢視回傳的座標，將它們對應到來源 - [GET /s2s/v2.0/task/teeth-whiten/pre-process/{task_id}](https://docs.perfectcorp.com/zh-tw/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/zh-tw/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/webhook)。 若您的整合不支援 webhook 或無法使用 - [GET /s2s/v2.0/task/teeth-whiten/{task_id}](https://docs.perfectcorp.com/zh-tw/reference/ai_teeth_whitening/v1.0/paths/~1s2s~1v2.0~1task~1teeth-whiten~1%7Btask_id%7D/get.md)