---
title: "Query Video Generation Task"
method: GET
path: "/v1/video/generations/{id}"
---

# Query Video Generation Task

`GET /v1/video/generations/{id}`

Retrieve the status and result of a Seedance 2.0 video generation task by its ID.

## Path parameters

- `id` string, required

## Response `200`

Task status retrieved

- TaskQueryResponse
  - `code` string — Response code.
  - `message` string — Response message.
  - `data` object
    - `task_id` string — Platform task ID.
    - `action` string — Generation action type, e.g. `generate`, `referenceGenerate`.
    - `status` 'NOT_START' | 'QUEUED' | 'IN_PROGRESS' | 'SUCCESS' | 'FAILURE' — Task status. `NOT_START` / `QUEUED` / `IN_PROGRESS` — keep polling. `SUCCESS` — read `result_url`. `FAILURE` — read `fail_reason`; quota auto-refunded.
    - `result_url` string — Pre-signed video download URL (valid 24 hours). Omitted on failure.
    - `original_result_url` string — **Ultra/super-resolution tasks only.** Upstream original (pre-enhancement) video URL.
    - `fail_reason` string — Error message when `status = FAILURE`. **Backward compat**: when `status = SUCCESS`, this is copied from `result_url` for legacy clients (will be removed after deprecation window).
    - `submit_time` integer — Task submit timestamp (Unix seconds).
    - `start_time` integer — Task start timestamp (Unix seconds). `0` if not started yet.
    - `finish_time` integer — Task finish timestamp (Unix seconds).
    - `progress` string — Task progress percentage.
    - `request_id` string — Request trace ID for support / debugging.
    - `data` object — Upstream raw output. Field set varies by model.
      - `content` object
        - `video_url` string — Generated video URL (same as outer `result_url` for non-ultra).
      - `created_at` integer
      - `draft` boolean
      - `duration` integer — Video duration (seconds).
      - `framespersecond` integer — Frames per second.
      - `generate_audio` boolean — Whether audio was generated.
      - `id` string — Upstream task ID.
      - `model` string — Upstream model ID.
      - `ratio` string — Video aspect ratio.
      - `resolution` string — Upstream raw resolution. **For ultra tasks** this is the lower upstream resolution (e.g. `480p`); the user-facing final resolution lives in `super_resolution`.
      - `super_resolution` string — **Ultra tasks only.** User-facing final resolution after super-resolution enhancement (e.g. `720p`, `2k`).
      - `seed` integer
      - `service_tier` string
      - `status` string — Upstream status: `succeeded`, `failed`, `running`, etc.
      - `updated_at` integer
      - `usage` object — Token usage. Ultra tasks include `super_resolution_tokens`.
        - `completion_tokens` integer — Upstream raw completion tokens.
        - `total_tokens` integer — Upstream raw total tokens.
        - `super_resolution_tokens` integer — **Ultra tasks only.** Tokens after applying the super-resolution coefficient — corresponds to the actual billed token count.

## Other responses

- `401` — Unauthorized
- `404` — Task not found

---

[API](https://skmtc.net/anyfast/apis/anthropic-claude-compatible-endpoint.md) · [All operations](https://skmtc.net/anyfast/apis/anthropic-claude-compatible-endpoint/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/anyfast/anthropic-claude-compatible-endpoint/revisions/edfc53e182a1/schema)