AI 臉部特徵與比例偵測

整合指南

• 如何為 AI 臉部特徵與比例偵測拍攝照片

• 正面自拍

  • 只需一張清晰的照片，直視鏡頭。最好讓頭髮自然垂落，整張臉可見且無遮蓋。將頭髮往後梳以露出額頭，並確保直視前方，拍攝標準的正面視角。
  • 或者，使用 JS Camera Kit 拍照。遵循自動臉部對齊、光線引導與臉部尺寸偵測，確保照片符合處理所需的標準。

• 如何用 AI 偵測膚況問題

1. 調整來源圖片尺寸
   調整您的照片以符合支援的尺寸。細節請參考**檔案規格與錯誤**

2. 使用 File API 上傳檔案
   使用 /s2s/v2.0/file API 上傳目標使用者圖片。

   • 圖片需求

     • 細節請參考**檔案規格與錯誤**。

   • 重要：僅呼叫 File API 並不會上傳您的檔案。您必須手動上傳檔案到File API 回應中提供的網址。該網址就是您的上傳目的地，請確保檔案成功傳輸到該處後再繼續。
     在呼叫 AI API 之前，請確保您的檔案已成功上傳。使用 File API 取得上傳網址，然後將檔案上傳到該位置。上傳完成後，您會在回應中取得 file_id，這個 ID 就是您用於存取該檔案相關 AI 功能的依據。

     警告： 請注意，若您未將檔案上傳到 File API 回應中提供的網址，使用 AI API 時會得到 500 Server Error / unknown_internal_error 或 404 Not Found 錯誤。

3. 執行 AI 臉部特徵與比例偵測任務
   上傳完成後，您可以使用檔案 ID 選擇多個要分析的臉部特徵。請參考**輸入與輸出**。
   接著，使用 檔案 ID 執行增強任務，並取得 task_id。

4. 輪詢以查詢任務狀態直到成功或錯誤
   這個 task_id 用於透過輪詢 GET 'task/face-attr-analysis' 監控任務狀態，以取得目前的引擎狀態。在引擎完成任務之前，狀態會維持為 'running'，此階段不會消耗點數。

   警告： 請注意，依據任務的保留期間輪詢以查詢任務狀態是強制性的。若在保留期間內沒有輪詢請求，任務將被逾時，即使任務已成功處理（您的點數仍會被消耗）。

   警告： 一旦您查詢已逾時任務的狀態，會得到 InvalidTaskId 錯誤。因此，執行 AI 任務後，您需要在保留期間內輪詢以查詢狀態，直到狀態變為 success 或 error。

5. 成功後取得 AI 任務的結果
   引擎成功處理您的輸入檔案並生成結果影像後，任務會變為 'success' 狀態。您會取得處理後影像的網址，以及一個 dst_id，讓您在無需重新上傳結果圖片的情況下串接另一個 AI 任務。 點數僅在這種情況下會被消耗。若引擎處理任務失敗，任務狀態會變為 'error'，且不會消耗點數。
   扣除點數時，系統會優先使用接近到期的點數。若到期日相同，則扣除最早取得的點數。

• 實際範例：

輸入與輸出

• 臉部特徵：

• 臉部比例：

• 拍攝建議：

警告： 臉部寬度需大於圖片寬度的 60%。

檔案規格與錯誤

• 支援的格式與尺寸

• 錯誤代碼

• 環境與相依性

JS Camera Kit

點數消耗

• 臉部特徵與比例偵測