AI 臉部拉提

整合指南

本指南將引導您完成：

AI 臉部拉提 API 的工作流程：

端點： /s2s/v2.0/task/face-lift

需要認證： Authorization: Bearer YOUR_API_KEY

工作流程步驟：

1. 圖片上傳準備：

• 準備要上傳的自拍圖片。
• 呼叫 File API /s2s/v2.0/file 取得上傳網址與相關的 file_id。
• 使用提供的上傳網址上傳自拍圖片。

2. 多張臉部的選填前處理：

   • 若圖片中有多於一張臉部，請對自拍圖片進行前處理。

3. 臉部拉提特效設定：

   • 先選擇合適的臉部拉提參數。

4. 啟動 AI 任務並取得任務 ID：

   • 透過 HTTP POST 請求，將 file_id 與所選特效設定傳送到 /s2s/v2.0/task/face-lift。
   • 在回應中取得唯一的任務 ID，用以識別這次互動。

5. 輪詢任務狀態（持續檢查）：

   • 使用取得的 task_id，透過 HTTP GET 請求（例如 GET /s2s/v2.0/task/face-lift${task_id}）定期輪詢任務狀態。
   • 持續監控：
     • Task_status = "success"（流程完成）。
     • Task_status = "error"（視情況解決或重試）。
   • 狀態轉為成功後，相應更新工作流程。

這個結構化的工作流程確保與使用者輸入的高效整合、任務的自動化監控，以及無縫取得結果。

1. 認證

   • 使用 Bearer Token 在請求標頭中納入您的 API key：
     Authorization: Bearer YOUR_API_KEY

   您可以在 https://yce.makeupar.com/api-console/en/api-keys/ 找到您的 API Key。

2. 上傳圖片

   您可以直接上傳檔案到伺服器，或在 AI 任務內容中提供有效的圖片網址。

   • 上傳端點

     POST /s2s/v2.0/file

   或者，若您已有公開的圖片網址，可跳過此步驟。

3. 透過前處理選擇要增強的目標臉部

   • 呼叫前處理 API 輸出以像素座標表示的偵測邊界框。使用結果的索引，在稍後建立臉部拉提 AI 任務。

     POST /s2s/v2.0/task/face-lift/pre-process

     {
         "timed": number,
         "result": [
             {
                 "left": number,
                 "top": number,
                 "width": number,
                 "height": number
             }
         ]
     }

4. 建立臉部拉提 AI 任務並輪詢結果

   當您取得圖片與完整的特效內容後，即可建立任務。API 以非同步方式處理請求。您必須輪詢任務狀態，直到達到 success 或 error。

   • 建立任務端點

     POST /s2s/v2.0/task/face-lift

   • 輪詢端點

     GET /s2s/v2.0/task/face-lift/{task_id}

檔案規格與錯誤

• AI 臉部拉提規範

支援的自拍視角 圖片不得大於 1920 x 1920，在長邊為 640 時須包含清晰可見且足夠大的臉部（超過 32 x 32 像素），且拍攝的 roll 角度在正負 75 度內、yaw 角度在正負 90 度內，以確保可靠的臉部偵測。

• 支援的格式與尺寸

• 錯誤代碼

• 環境與相依性

JS Camera Kit

點數消耗