---
title: "Get task status"
method: GET
path: "/api/generate/status/{task_id}"
tags: ["Task Management"]
---

# Get task status

`GET /api/generate/status/{task_id}`

Query the status and results of a generation task

## Path parameters

- `task_id` string, required

## Response `200`

Task status retrieved successfully

- StatusResponse
  - `code` integer, required — HTTP status code
  - `data` object, required
    - `task_id` string, required — Unique task identifier
    - `status` 'not_started' | 'running' | 'finished' | 'failed', required — Current task status
    - `credits_amount` number, required — Credits charged for the task
    - `files` object[], required — Generated media files (populated when status is finished)
      - `file_url` string, uri, required — Direct URL to the generated file (valid for 24 hours)
      - `file_type` 'image' | 'video' | '3d' | 'other', required — Type of generated file: 'image', 'video', '3d', or 'other'
      - `label` string — Optional file label, commonly used for 3D outputs
      - `format` string — Optional file format, such as glb, fbx, obj, png, or mp4
      - `content_type` string — Optional MIME type of the generated file
      - `file_name` string — Optional file name
      - `file_size` integer — Optional file size in bytes
    - `created_time` string, date-time, required — ISO 8601 timestamp of task creation
    - `progress` integer, required — Completion percentage
    - `error_message` string, nullable — Error description (when status is failed)

## Other responses

- `404` — Task not found

---

[API](https://skmtc.net/poyo/apis/poyo-ai-hunyuan-3d-v3-1-api.md) · [All operations](https://skmtc.net/poyo/apis/poyo-ai-hunyuan-3d-v3-1-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/poyo/poyo-ai-hunyuan-3d-v3-1-api/revisions/4b46904b78eb/schema)