---
title: "Seedance Action dispatcher (GET)"
method: GET
path: "/api/v3"
tags: ["Seedance Volc Compatible"]
---

# Seedance Action dispatcher (GET)

`GET /api/v3`

## Request

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

Dispatches Volc-style Action requests. Use Version=2024-01-01 or omit Version.

## Query parameters

- `Action` 'CreateContentsGenerationsTasks' | 'GetContentsGenerationsTask' | 'ListContentsGenerationsTasks' | 'DeleteContentsGenerationsTasks', required
- `Version` string

## Response `200`

Action response. Create/Get/List actions return JSON; DeleteContentsGenerationsTasks returns an empty body.

- union
  - VolcSeedanceCreateTaskResponse
    - `id` string, required
  - VolcSeedanceTask
    - `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.
  - 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)