Video Generation API
Create Seedance video tasks with per-second billing, then read the finished clip from the task status response.
The GetToken Video Generation API covers text-to-video, reference-to-video, and first/last-frame video across the Volcengine Ark Seedance family, with every tier billed at a flat 75% of the vendor price. Generation is asynchronous: create a task, poll its status, and read the video file URL from the result once the task completes.
Every request requires a dedicated service_type=video_api key. Video keys are managed separately from text and image keys and cannot be used interchangeably; create one from Console → Video Generation API. Billing is per second against account balance and does not consume subscription quota.
Product page with the live price list:
https://gettoken.dev/video-apiEndpoints
- Base URL:
https://api.clawto.link(alternate:https://api.gettoken.dev) - Endpoints:
POST /v1/videos(create a task;/v1/videos/generationsis accepted too)GET /v1/videos/{task_id}(task status and result)
- Auth:
Authorization: Bearer <video API key> - Body:
Content-Type: application/json
The supplier route supports creation and status polling only. Editing, extension, and proxied content downloads are out of scope; use the upstream URL in the result once the task completes.
Models
Model (model) | Resolutions | Clip length | Input modes |
|---|---|---|---|
toks/seedance_2.5 | 480p / 720p / 1080p | 4–30s | text, reference, first/last frame |
toks/seedance_2.5_draft | 480p | 4–30s | text, reference, first/last frame |
toks/seedance_2.0 | 720p / 1080p / 4K | 4–15s | text, reference, first/last frame |
toks/seedance_2.0_fast | 720p | 4–15s | text, reference, first/last frame |
toks/seedance_2.0_mini | 720p | 4–15s | text, reference, first/last frame |
The toks/ channel prefix is required. It routes the request to the video supplier channel; without it the model is treated as unknown.
Create parameters
| Parameter | Type | Notes |
|---|---|---|
model | string | Required, full model name including the toks/ prefix |
prompt | string | Required for text-to-video; optional for reference-to-video |
resolution | string | Required, see the table above; 4k only applies to seedance_2.0 |
duration | integer | Required, whole seconds; the valid range depends on the model |
n | integer | Optional, 1–4, defaults to 1 |
size | string | Optional aspect ratio such as 16:9, 9:16, 1:1; pixel sizes are rejected |
mode | string | Optional: t2v, m2v, first_last_frame; inferred from the payload when omitted |
first_frame | string | Required for first/last-frame mode; public URL or Data URL |
last_frame | string | Optional end frame; must accompany first_frame |
reference_images | string[] | Reference-to-video input, up to 9 |
reference_videos | string[] | Reference-to-video input, up to 3 |
reference_audios | string[] | Reference-to-video input, up to 3 |
mode inference: first_frame present means first_last_frame; any reference_* means m2v; otherwise t2v.
These fields are rejected with 400 when present: quality, style, seed, negative_prompt, width, height, watermark, background, output_format.
Reference media accepts public HTTP/HTTPS URLs and data:image/png;base64,, data:image/jpeg;base64,, or data:image/webp;base64, Data URLs. URLs carrying credentials are rejected.
Create a text-to-video task
curl --fail https://api.clawto.link/v1/videos \
-H "Authorization: Bearer YOUR_VIDEO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "toks/seedance_2.0_fast",
"prompt": "A quiet city street after rain, slow dolly forward",
"resolution": "720p",
"duration": 5,
"size": "16:9"
}'A successful create returns 202 with the task ID and poll path:
{
"id": "vsvid_2f6c1d0e-7b1a-4c62-9d05-8f9a1c3e5b70",
"object": "video",
"model": "seedance_2.0_fast",
"status": "in_progress",
"duration": 5,
"resolution": "720p",
"n": 1,
"poll_url": "/v1/videos/vsvid_2f6c1d0e-7b1a-4c62-9d05-8f9a1c3e5b70",
"reserved_usd": 12.0,
"charged_usd": 0,
"refunded_usd": 0
}reserved_usd is the credit reserved at submit time (unit price × seconds × clips). charged_usd is only written when the task completes.
Create a first/last-frame task
curl --fail https://api.clawto.link/v1/videos \
-H "Authorization: Bearer YOUR_VIDEO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "toks/seedance_2.5",
"prompt": "The subject walks naturally toward the camera",
"resolution": "720p",
"duration": 8,
"size": "16:9",
"first_frame": "https://example.com/first.png",
"last_frame": "https://example.com/last.png"
}'first_frame and last_frame must appear together; sending only an end frame returns 400.
Poll task status
curl --fail \
-H "Authorization: Bearer YOUR_VIDEO_API_KEY" \
https://api.clawto.link/v1/videos/vsvid_2f6c1d0e-7b1a-4c62-9d05-8f9a1c3e5b70| Status | Handling |
|---|---|
queued / in_progress | Still running, keep polling |
completed | Done, read result and download |
failed | Failed, the reserved credit is refunded |
expired | Artifacts expired; not a failure, reconcile manually |
Poll every 5–10 seconds. A completed task carries the upstream result:
{
"id": "vsvid_2f6c1d0e-7b1a-4c62-9d05-8f9a1c3e5b70",
"object": "video",
"model": "seedance_2.0_fast",
"status": "completed",
"duration": 5,
"resolution": "720p",
"n": 1,
"poll_url": "/v1/videos/vsvid_2f6c1d0e-7b1a-4c62-9d05-8f9a1c3e5b70",
"reserved_usd": 12.0,
"charged_usd": 12.0,
"refunded_usd": 0,
"result": [
{
"url": "https://<supplier-result-host>/<object-path>.mp4",
"download_url": "https://<supplier-result-host>/<object-path>.mp4",
"file_name": "job_2f6c1d0e.mp4",
"bytes": 11017312,
"expires_at": 1794628614
}
]
}result is an array whose length equals the number of successfully generated clips. expires_at is a Unix timestamp in seconds; move the file to your own storage before it lapses. Polling after expiry yields an empty result or the expired status.
Errors and retries
| HTTP | type | Meaning |
|---|---|---|
| 400 | invalid_request_error | Invalid parameters: missing model or resolution, duration out of range, unsupported fields |
| 400 | video_request_rejected | Create rejected, e.g. unpriced model or disabled channel |
| 402 | insufficient_balance | Balance cannot cover the reserved amount |
| 404 | video_task_not_found | Task missing or not owned by this key |
| 415 | — | Content-Type is not application/json |
| 429 | quota_exhausted | Key quota or rate limit reached |
Do not blind-retry an ambiguous create: query the returned task ID first, and resubmit only after confirming the task was not accepted. Otherwise you risk duplicate tasks and duplicate charges.
Pricing (per second)
Prices are credit unit prices; RMB assumes about ¥0.25 per $1 of credit. Charge = unit price × seconds × successful clips.
Each tier starts from the vendor's RMB price per second, converts it at ¥0.25 per $1 of credit, and then applies a 0.75 discount factor — which is why every tier comes in exactly 25% below the vendor price.
| Model | 480p | 720p | 1080p | 4K |
|---|---|---|---|---|
seedance_2.5 | $2.01 | $4.53 | $11.22 | — |
seedance_2.5_draft | $2.01 | — | — | — |
seedance_2.0 | — | $2.97 | $7.44 | $15.15 |
seedance_2.0_fast | — | $2.40 | — | — |
seedance_2.0_mini | — | $1.50 | — | — |
In RMB: seedance_2.0_mini 720p is ¥0.375 per second — ¥1.88 for a 5-second clip; seedance_2.0_fast 720p is ¥0.60 per second — ¥3.00 for 5 seconds.
Only sellable tiers are listed. A tier whose upstream cost exceeds the vendor price stays closed for now and is rejected as an invalid parameter.
Billing boundaries:
- Creating a task reserves
unit price × seconds × clips, reported asreserved_usd. - Settlement happens on completion using the successful clip count and never exceeds the reserved amount.
failedrefunds the reservation;unknown(create timeout, dropped connection) stays reserved for manual reconciliation.- Status polling is not billed again.
Notes
- Video keys only work on video endpoints; text keys return 401 there.
- Video charges come from balance only and do not consume subscription quota.
- Each request generates at most 4 clips; throttle concurrency on batch jobs yourself.
- Upstream result links expire, so download the clip promptly after completion.