> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tokenlab.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Task (Volc Compatible)

> Get a Seedance compatibility task by its cgt task ID.

## Overview

Use the `cgt-...` ID returned by create. Poll every few seconds while the task is `queued` or `running`. Stop when the task is `succeeded`, `failed`, `cancelled`, or `expired`.

See also [Seedance 2.0 Video Models](/guides/seedance-2-video) and [Video Generation](/guides/video-generation).

## Status Values

* `queued`: accepted and waiting to run.
* `running`: generation is in progress.
* `succeeded`: result is ready and `content.video_url` is present.
* `failed`: generation failed; inspect `error.code` and `error.message`.
* `cancelled`: the task was cancelled before completion.
* `expired`: the task expired before completion.

## Response Fields

* `id`: compatibility task ID, starting with `cgt-`.
* `model`: model identifier echoed for compatibility.
* `status`: one of the status values above.
* `progress`: returned only when a real progress value is available.
* `content.video_url`: final video URL on success.
* `content.last_frame_url`: present only when requested and available.
* `usage`: token usage when available.
* `created_at` and `updated_at`: task timestamps.

## Example

```bash theme={null}
curl https://api.tokenlab.sh/api/v3/contents/generations/tasks/cgt-0123456789abcdef0123456789abcdef \
  -H "Authorization: Bearer $TOKENLAB_API_KEY"
```

```json theme={null}
{
  "id": "cgt-0123456789abcdef0123456789abcdef",
  "model": "doubao-seedance-2-0-260128",
  "status": "succeeded",
  "content": {
    "video_url": "https://example.com/result.mp4"
  },
  "usage": {
    "completion_tokens": 123456
  },
  "error": null
}
```