---
title: "Query Task"
method: GET
path: "/v1/common_task/motion_control/task/query"
---

# Query Task

`GET /v1/common_task/motion_control/task/query`

Query Motion Control task status and output by `taskId`. Unfinished tasks are returned as `running`.

## Query parameters

- `taskId` string, required
- `needCloudFrontUrl` boolean

## Headers

- `Topview-Uid` string, required
- `Authorization` string, required

## Response `200`

Success

- object
  - `code` string
  - `message` string
  - `result` object
    - `taskId` string — Task ID
    - `status` 'init' | 'running' | 'success' | 'fail' — Task status
    - `errorMsg` string — Error message when failed
    - `costCredit` number, float — Consumed credit
    - `boardId` string — Associated board ID (if any)
    - `outputVideoUrl` string — Output video URL
    - `outputCoverUrl` string — Output cover URL
    - `outputVideoFileId` string — Output video fileId
    - `outputCoverFileId` string — Output cover fileId
    - `outputWidth` integer — Output video width
    - `outputHeight` integer — Output video height
    - `outputDuration` integer — Output duration in milliseconds

---

[API](https://skmtc.net/topview/apis/image-character-swap-apis-editable-in-readme.md) · [All operations](https://skmtc.net/topview/apis/image-character-swap-apis-editable-in-readme/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/topview/image-character-swap-apis-editable-in-readme/versions/83cd46ca7859/schema)