跳转到内容

查詢 AI 臉部塑型偵測任務的狀態。

请求

當來源照片可能包含超過一個有效目標,或您的整合需要明確選擇哪個被偵測到的目標接受特效時,請使用前處理任務。對於單一目標的圖片,當功能支援預設的 index 值,且您的應用程式不需要手動選擇目標時,可以跳過前處理。

前處理任務會偵測來源照片中的候選目標,並在 data.results.result 中回傳它們的座標。結果陣列中的每個項目代表一個被偵測到的目標。檢視回傳的座標,將它們對應到來源照片中預期的臉部或區域,並在建立特效任務時,將該項目的零基陣列索引作為 index 值使用。

對於偵測到多張臉或多個區域的圖片,請不要在未檢查前處理結果的情況下依賴預設的 index 值。特效只會套用到由 index 選定的目標,因此整合必須在執行特效任務前,確認對應到預期目標的結果項目。

這個任務是非同步的。建立任務後,若功能支援,請以 webhook 處理完成,否則輪詢對應的前處理狀態端點,直到 data.task_status 為 success 或 error。

安全
BearerAuthenticationV2
路径
task_idstring必需

要查詢的任務 ID

示例:grH0CvsgXuAIHLUzD0V1Ol34hoet3R1tvdbtiVHrDb6_UqCLKIejAIajwxrhOAfe
curl -i -X GET \
  https://yce-api-01.makeupar.com/s2s/v2.0/task/face-reshape/pre-process/grH0CvsgXuAIHLUzD0V1Ol34hoet3R1tvdbtiVHrDb6_UqCLKIejAIajwxrhOAfe \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

响应

成功查詢任務狀態

正文application/json
statusinteger

回應狀態

示例:200
dataobject
响应
{ "status": 200, "data": { "task_status": "running", "error": "error_exceed_max_image_size", "error_message": "string", "results": { … } } }