---
title: "Query Task Status"
method: GET
path: "/v1/tasks/{task_id}"
tags: ["Task Management"]
---

# Query Task Status

`GET /v1/tasks/{task_id}`

Query the status, progress, and result information of asynchronous tasks by task ID

## Path parameters

- `task_id` string, required

## Response `200`

Task status details

- TaskDetailResponse
  - `created` integer — Task creation timestamp
  - `id` string — Task ID
  - `model` string — Model used
  - `object` 'image.generation.task' | 'video.generation.task' | 'audio.generation.task' — Task type
  - `progress` integer — Task progress percentage
  - `results` string[] — Task result list (provided when completed)
  - `status` 'pending' | 'processing' | 'completed' | 'failed' — Task status
  - `error` object, nullable — Error information when the task fails (only present when status is "failed"). Note: error.code here is a string-type business error code, different from HTTP status codes. See the Error Codes Reference for the complete list.
    - `code` string — Business error code (string type)
    - `message` string — User-friendly error description with troubleshooting tips
    - `type` string — Error type identifier, always "task_error"
  - `task_info` object — Task detailed information
    - `can_cancel` boolean — Whether the task can be cancelled
  - `type` 'image' | 'video' | 'audio' | 'text' — Task type

## Other responses

- `400` — Request parameter error, format error
- `401` — Unauthenticated, token invalid or expired
- `402` — Insufficient quota, recharge required
- `403` — No permission to access
- `404` — Resource does not exist
- `429` — Request rate limit exceeded
- `500` — Internal server error

---

[API](https://skmtc.dev/evolink/apis/get-credits-usage-api.md) · [All operations](https://skmtc.dev/evolink/apis/get-credits-usage-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/evolink/get-credits-usage-api/revisions/88edb0ec881f/schema)