---
title: "List Seedance tasks (Volc-compatible)"
method: GET
path: "/api/v3/contents/generations/tasks"
tags: ["Seedance Volc Compatible"]
---

# List Seedance tasks (Volc-compatible)

`GET /api/v3/contents/generations/tasks`

## Request

- Base URL: `https://api.tokenlab.sh`
- URL: `https://api.tokenlab.sh/api/v3/contents/generations/tasks`
- Auth: HTTP bearer

Lists recent Seedance compatibility tasks for the authenticated organization.

## Query parameters

- `page_num` integer
- `page_size` integer
- `filter.status` 'queued' | 'running' | 'succeeded' | 'failed' | 'cancelled' | 'expired'
- `filter.task_ids` string[]
- `filter.model` string
- `filter.service_tier` string

## Response `200`

Task list

- VolcSeedanceTaskListResponse
  - `items` VolcSeedanceTask[], required
    - `id` string, required
    - `model` string, required
    - `status` 'queued' | 'running' | 'succeeded' | 'failed' | 'cancelled' | 'expired', required
    - `content` object
      - `video_url` string, uri
      - `last_frame_url` string, uri
    - `seed` integer
    - `resolution` string
    - `ratio` string
    - `duration` string
    - `frames` integer
    - `framespersecond` integer
    - `generate_audio` boolean
    - `tools` object
      - `type` 'web_search'
    - `safety_identifier` string
    - `draft` boolean
    - `draft_task_id` string
    - `service_tier` string
    - `execution_expires_after` integer
    - `usage` object
      - `completion_tokens` integer
      - `total_tokens` integer
      - `tool_usage` object
        - `web_search` integer
    - `error` object
      - `code` string, required
      - `message` string, required
    - `created_at` integer: Unix timestamp in seconds.
    - `updated_at` integer: Unix timestamp in seconds.
  - `total` integer, required

## Other responses

- `400`: Invalid request
- `401`: Missing or unsupported authentication
- `500`: Internal error

---

[API](https://skmtc.dev/tokenlab/apis/tokenlab-ai-gateway.md) · [All operations](https://skmtc.dev/tokenlab/apis/tokenlab-ai-gateway/llms.txt) · [OpenAPI document](https://skmtc.dev/tokenlab/apis/tokenlab-ai-gateway/revisions/3208bfbcda22?raw)