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

当源图中可能存在多个有效目标，或您的接入需要显式指定特效作用在哪个已检测目标上时，请使用预处理任务。若图片只有一个目标，且功能支持默认的 `index` 取值、您的应用也不需要手动挑选目标，这一步可以省略。
预处理任务会在源图中检测候选目标，并把它们的坐标返回在 `data.results.result` 中。结果数组里的每一项对应一个检测到的目标。请查看返回的坐标，与源图中您要处理的脸部或区域对应起来，然后在创建特效任务时，把该项的下标（从 0 开始）作为 `index` 传入。
图中检测到多张脸或多个区域时，请不要不看预处理结果就直接使用默认的 `index` 取值。特效只会作用在 `index` 选中的那个目标上，因此在运行特效任务之前，接入方必须先确认结果中哪一项才是您要处理的目标。
本任务为异步任务。创建任务后，若功能支持 Webhook，请用 Webhook 接收完成通知；否则轮询对应的预处理状态接口，直到 `data.task_status` 变为 `success` 或 `error`。

Endpoint: GET /s2s/v2.0/task/face-reshape/pre-process/{task_id}
Security: BearerAuthenticationV2

## Security:

  - `BearerAuthenticationV2` (unknown)
    http bearer

## Path parameters:

  - `task_id` (string, required)
    要查询的任务 ID

## Response 200:

  - `200` (unknown)
    任务状态查询成功

## Response 200 fields (application/json):

  - `status` (integer)
    响应状态
    Example: 200

  - `data` (object)

  - `data.results` (object)

  - `data.results.timed` (number)

  - `data.results.result` (array)

  - `data.results.result.left` (number)

  - `data.results.result.top` (number)

  - `data.results.result.width` (number)

  - `data.results.result.height` (number)

## Response 400:

  - `400` (unknown)
    任务 ID 无效

## Response 400 fields (application/json):

  - `status` (integer)
    响应状态
    Example: 400

  - `error` (string)
    Example: Invalid task ID

## Response 401:

  - `401` (unknown)
    API 密钥无效或缺失

## Response 401 fields (application/json):

  - `status` (integer)
    响应状态
    Example: 401

  - `error` (string)
    Example: Invalid API key

## Response 500:

  - `500` (unknown)
    任务执行超时

## Response 500 fields (application/json):

  - `status` (integer)
    响应状态
    Example: 500

  - `error` (string)
    Example: Task execution timed out