---
title: "Query Omni Reference Task Result"
method: GET
path: "/v1/common_task/omni_reference/task/query"
---

# Query Omni Reference Task Result

`GET /v1/common_task/omni_reference/task/query`

Query the result of an Omni Reference video generation task. Returns the task status, generated videos, and related information. Different responses are returned based on task status: init/running (processing), success (videos available), or fail (with error message).

## 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 (submitted), running (processing), success (completed), fail (failed)
    - `errorMsg` string — Error message (returned when status=fail or during processing issues)
    - `costCredit` number, float — Credits consumed for this task
    - `boardId` string — Associated Board ID (returned if task was created from a board)
    - `videos` object[] — Generated video list (empty until task succeeds)
      - `status` string — Video generation status: init, running, success, fail
      - `errorMsg` string — Error message if video generation failed
      - `fileId` string — File record ID generated by uploadService.insertFileRecord
      - `filePath` string — Video file path (S3 URL or local path)
      - `width` integer — Video width in pixels
      - `height` integer — Video height in pixels
      - `duration` integer — Video duration in milliseconds
      - `coverPath` string — Thumbnail/cover image path
      - `boardTaskId` string — Associated Board Task ID (returned if task was created from a board)

---

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