---
title: "Query Task"
method: GET
path: "/v1/common-task/video-object-remove/query"
---

# Query Task

`GET /v1/common-task/video-object-remove/query`

Poll task status and outputs by taskId. Output fields are empty until the task succeeds. On success, returns the output video URL, cover URL, file IDs, and dimension info.

## Query parameters

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

## Headers

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

## Response `200`

Task query successful

- object
  - `code` string — Response status code
  - `message` string — Response message
  - `result` object — Task result data
    - `taskId` string — Task ID
    - `status` 'init' | 'running' | 'success' | 'fail' — Task status: init (accepted, not yet started); running (in progress; any unfinished state is normalized to running); success (completed); fail (failed)
    - `errorMsg` string — Error message; returned only when status is fail
    - `costCredit` number, float — Credits actually consumed by this task. Default 0.000. Charged after success based on the input video duration.
    - `boardId` string — Associated Board ID (returned only if the task was created from a board)
    - `outputVideoUrl` string — Output video URL, returned only after the task succeeds. When needCloudFrontUrl=true, a CloudFront URL is preferred for acceleration.
    - `outputCoverUrl` string — Output cover image URL, returned only after the task succeeds. When needCloudFrontUrl=true, a CloudFront URL is preferred for acceleration.
    - `outputVideoFileId` string — Output video fileId (returned after success). Can be reused as input fileId for downstream APIs.
    - `outputCoverFileId` string — Output cover fileId (returned after success)
    - `outputWidth` integer — Output video width in pixels (returned after success)
    - `outputHeight` integer — Output video height in pixels (returned after success)
    - `outputDuration` integer — Output video duration in milliseconds (returned after success)

---

[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)