---
title: "GET /happyhorse/api/v1/tasks/{task_id}"
method: GET
path: "/happyhorse/api/v1/tasks/{task_id}"
---

# GET /happyhorse/api/v1/tasks/{task_id}

`GET /happyhorse/api/v1/tasks/{task_id}`

Query Task Result - Query the status and result of video generation task by task ID

## Path parameters

- `task_id` string, required

## Response `200`

Query task result successful

- object
  - `request_id` string, required — Request unique identifier. Can be used for request tracing and troubleshooting.
  - `output` object, required — Task output information
    - `task_id` string, required — Task ID. Valid for 24 hours.
    - `task_status` 'PENDING' | 'RUNNING' | 'SUCCEEDED' | 'FAILED' | 'CANCELED' | 'UNKNOWN', required — Task status
    - `code` string — Error code. Only returned when task_status is FAILED.
    - `message` string — Error message. Only returned when task_status is FAILED.
    - `submit_time` string — Task submit time. Timezone is UTC+8, format: YYYY-MM-DD HH:mm:ss.SSS. Only returned when task succeeds.
    - `scheduled_time` string — Task execution time. Timezone is UTC+8, format: YYYY-MM-DD HH:mm:ss.SSS. Only returned when task succeeds.
    - `end_time` string — Task completion time. Timezone is UTC+8, format: YYYY-MM-DD HH:mm:ss.SSS. Only returned when task succeeds.
    - `orig_prompt` string — Original input prompt, corresponds to the request parameter prompt. Only returned when task succeeds.
    - `video_url` string — Video URL. Only returned when task_status is SUCCEEDED. Link is valid for 24 hours, you can download the video through this URL. Video format is MP4 (H.264 encoding).
  - `usage` object — Output information statistics. Only counted for successful results.
    - `duration` number — Total video duration of generated video, used for billing.
    - `input_video_duration` number — Input video duration in seconds.
    - `output_video_duration` number — Output video duration in seconds.
    - `video_count` integer — Number of generated videos. Fixed at 1.
    - `SR` integer — Resolution level of generated video.
    - `ratio` string — Aspect ratio of generated video.

---

[API](https://skmtc.net/ttapi/apis/flowmusic-api-docs.md) · [All operations](https://skmtc.net/ttapi/apis/flowmusic-api-docs/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ttapi/flowmusic-api-docs/versions/f27f8a59dbd0/schema)