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-api

Endpoints

  • Base URL: https://api.clawto.link (alternate: https://api.gettoken.dev)
  • Endpoints:
    • POST /v1/videos (create a task; /v1/videos/generations is 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)ResolutionsClip lengthInput modes
toks/seedance_2.5480p / 720p / 1080p4–30stext, reference, first/last frame
toks/seedance_2.5_draft480p4–30stext, reference, first/last frame
toks/seedance_2.0720p / 1080p / 4K4–15stext, reference, first/last frame
toks/seedance_2.0_fast720p4–15stext, reference, first/last frame
toks/seedance_2.0_mini720p4–15stext, 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

ParameterTypeNotes
modelstringRequired, full model name including the toks/ prefix
promptstringRequired for text-to-video; optional for reference-to-video
resolutionstringRequired, see the table above; 4k only applies to seedance_2.0
durationintegerRequired, whole seconds; the valid range depends on the model
nintegerOptional, 1–4, defaults to 1
sizestringOptional aspect ratio such as 16:9, 9:16, 1:1; pixel sizes are rejected
modestringOptional: t2v, m2v, first_last_frame; inferred from the payload when omitted
first_framestringRequired for first/last-frame mode; public URL or Data URL
last_framestringOptional end frame; must accompany first_frame
reference_imagesstring[]Reference-to-video input, up to 9
reference_videosstring[]Reference-to-video input, up to 3
reference_audiosstring[]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
StatusHandling
queued / in_progressStill running, keep polling
completedDone, read result and download
failedFailed, the reserved credit is refunded
expiredArtifacts 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

HTTPtypeMeaning
400invalid_request_errorInvalid parameters: missing model or resolution, duration out of range, unsupported fields
400video_request_rejectedCreate rejected, e.g. unpriced model or disabled channel
402insufficient_balanceBalance cannot cover the reserved amount
404video_task_not_foundTask missing or not owned by this key
415—Content-Type is not application/json
429quota_exhaustedKey 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.

Model480p720p1080p4K
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 as reserved_usd.
  • Settlement happens on completion using the successful clip count and never exceeds the reserved amount.
  • failed refunds 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.

On this page