当源图中可能存在多个有效目标,或您的接入需要显式指定特效作用在哪个已检测目标上时,请使用预处理任务。若图片只有一个目标,且功能支持默认的 index 取值、您的应用也不需要手动挑选目标,这一步可以省略。
预处理任务会在源图中检测候选目标,并把它们的坐标返回在 data.results.result 中。结果数组里的每一项对应一个检测到的目标。请查看返回的坐标,与源图中您要处理的脸部或区域对应起来,然后在创建特效任务时,把该项的下标(从 0 开始)作为 index 传入。
图中检测到多张脸或多个区域时,请不要不看预处理结果就直接使用默认的 index 取值。特效只会作用在 index 选中的那个目标上,因此在运行特效任务之前,接入方必须先确认结果中哪一项才是您要处理的目标。
本任务为异步任务。创建任务后,若功能支持 Webhook,请用 Webhook 接收完成通知;否则轮询对应的预处理状态接口,直到 data.task_status 变为 success 或 error。
安全
BearerAuthenticationV2
- https://yce-api-01.makeupar.comhttps://yce-api-01.makeupar.com/s2s/v2.0/task/fitzpatrick-scale-analyzer/pre-process
curl -i -X POST \
https://yce-api-01.makeupar.com/s2s/v2.0/task/fitzpatrick-scale-analyzer/pre-process \
-H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
-H 'Content-Type: application/json' \
-d '{
"src_file_url": "https://example.com/selfie.jpg"
}'响应
{ "status": 200, "data": { "task_id": "grH0CvsgXuAIHLUzD0V1Ol34hoet3R1tvdbtiVHrDb6_UqCLKIejAIajwxrhOAfe" } }