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

# Query Task

`GET /v1/instant_voice_clone/task/query`

Query 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)
    - `model` string — Submitted display model name
    - `text` string — Submitted script text
    - `outputAudio` object — Output audio info (returned on success)
      - `fileId` string — Output audio fileId
      - `url` string — Output audio URL
      - `duration` number, float — Output audio duration in seconds
      - `format` string — Output audio format

---

[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/revisions/83cd46ca7859/schema)