跳转到内容

执行 AI 牙齿美白 检测任务。

请求

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

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

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

本任务为异步任务。创建任务后,若功能支持 Webhook,请用 Webhook 接收完成通知;否则轮询对应的预处理状态接口,直到 data.task_status 变为 success 或 error。

安全
BearerAuthenticationV2
正文application/json必需
Any of:
src_file_urlstring必需

用于运行任务的文件 URL,该 URL 需可公开访问。

示例:"https://example.com/selfie.jpg"
curl -i -X POST \
  https://yce-api-01.makeupar.com/s2s/v2.0/task/teeth-whiten/pre-process \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "src_file_url": "https://example.com/selfie.jpg"
  }'

响应

任务执行成功

正文application/json
statusinteger

响应状态

示例:200
dataobject
响应
{ "status": 200, "data": { "task_id": "grH0CvsgXuAIHLUzD0V1Ol34hoet3R1tvdbtiVHrDb6_UqCLKIejAIajwxrhOAfe" } }