# 查詢 AI 頭髮密度分析任務的狀態。

Endpoint: GET /s2s/v2.0/task/hair-density-detection/{task_id}
Security: BearerAuthenticationV2

## Security:

  - `BearerAuthenticationV2` (unknown)
    http bearer

## Path parameters:

  - `task_id` (string, required)
    要查詢的任務 ID

## Response 200:

  - `200` (unknown)
    成功查詢 AI 頭髮密度分析任務的狀態。

## 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`
 - 超過重試上限，以避免生成 NSFW 圖片
- `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.timed` (number)

  - `data.results.hair_density` (object)

  - `data.results.hair_density.mapping` (string)
    以字串格式表示的浮點數
    Example: 2.16

  - `data.results.hair_density.term` (string)
    Enum: "Extremely Low Density", "Low Density", "Medium Density", "High Density"

## 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 Key 無效、已停用或已到期

## Response 401 fields (application/json):

  - `status` (integer)
    回應狀態
    Example: 401

  - `error_code` (string)
    錯誤代碼：
* InvalidApiKey - 未提供 API Key，或 API Key 無效
* InactiveApiKey - API Key 已停用
* ExpiredApiKey - API Key 已到期
    Enum: "InvalidApiKey", "InactiveApiKey", "ExpiredApiKey"

## Response 500:

  - `500` (unknown)
    任務在預期時間內沒有回應

## Response 500 fields (application/json):

  - `status` (integer)
    回應狀態
    Example: 500

  - `error_code` (string)
    錯誤代碼：
* TaskTimeout - 任務在預期時間內沒有回應
    Enum: "TaskTimeout"