跳转到内容

查询 AI 面部塑形 检测任务的状态。

请求

当源图中可能存在多个有效目标,或您的接入需要显式指定特效作用在哪个已检测目标上时,请使用预处理任务。若图片只有一个目标,且功能支持默认的 index 取值、您的应用也不需要手动挑选目标,这一步可以省略。

预处理任务会在源图中检测候选目标,并把它们的坐标返回在 data.results.result 中。结果数组里的每一项对应一个检测到的目标。请查看返回的坐标,与源图中您要处理的脸部或区域对应起来,然后在创建特效任务时,把该项的下标(从 0 开始)作为 index 传入。

图中检测到多张脸或多个区域时,请不要不看预处理结果就直接使用默认的 index 取值。特效只会作用在 index 选中的那个目标上,因此在运行特效任务之前,接入方必须先确认结果中哪一项才是您要处理的目标。

本任务为异步任务。创建任务后,若功能支持 Webhook,请用 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": { … } } }