# 查询 AI 发型发长检测任务的状态。

Endpoint: GET /s2s/v2.0/task/hair-length-detection/{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.task_status` (string)
    任务状态
    Enum: "running", "success", "error"

  - `data.error` (string)
    错误码：
- `exceed_max_filesize`
 - 输入文件大小超出上限
- `invalid_parameter`
 - 参数取值无效
- `error_download_image`
 - 下载原图出错
- `error_download_mask`
 - 下载蒙版图片出错
- `error_decode_image`
 - 解码原图出错
- `error_decode_mask`
 - 解码蒙版图片出错
- `error_nsfw_content_detected`
 - 在原图中检测到不适宜内容（NSFW）
- `error_no_face`
 - 原图中没有检测到人脸
- `error_pose`
 - 原图的姿态检测失败
- `error_face_parsing`
 - 原图的人脸分割失败
- `error_inference`
 - 推理流程中出现错误
- `exceed_nsfw_retry_limits`
 - 为避免生成不适宜内容， 重试次数已用尽
- `error_upload`
 - 上传结果图片出错
- `unknown_internal_error`
 - 其他错误
    Enum: "exceed_max_filesize", "invalid_parameter", "error_download_image", "error_download_mask", "error_decode_image", "error_decode_mask", "error_nsfw_content_detected", "error_no_face", "error_pose", "error_face_parsing", "error_inference", "exceed_nsfw_retry_limits", "error_upload", "unknown_internal_error"

  - `data.error_message` (string)
    错误的详细说明

  - `data.results` (object)

  - `data.results.hair_length` (object)

  - `data.results.hair_length.term` (string)
    发长预测结果
    Enum: "above the ears", "ear length", "ear length or longer", "short hair", "short hair or longer", "above chest", "above chest or longer", "long hair"

## Response 400:

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

## Response 400 fields (application/json):

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

  - `error_code` (string)
    错误码：
* InvalidTaskId - 任务 ID 无效
    Enum: "InvalidTaskId"

## Response 401:

  - `401` (unknown)
    API 密钥无效、已停用或已过期

## Response 401 fields (application/json):

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

  - `error_code` (string)
    错误码：
* InvalidApiKey - 未提供 API 密钥，或密钥无效
* InactiveApiKey - API 密钥已被停用
* ExpiredApiKey - API 密钥已过期
    Enum: "InvalidApiKey", "InactiveApiKey", "ExpiredApiKey"

## Response 500:

  - `500` (unknown)
    任务在预期时间内没有响应

## Response 500 fields (application/json):

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

  - `error_code` (string)
    错误码：
* TaskTimeout - 任务在预期时间内没有响应
    Enum: "TaskTimeout"