Seedance Volc Compatible

Create Seedance task (Volc wire-compatible)

Creates a Seedance 2.0 video task with the official Volc REST body and response shape. Authentication uses a TokenLab Bearer API key. TokenLab additionally accepts an optional Idempotency-Key header so a client can recover the same task ID after a lost create response.

post/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

Headers

X-TokenLab-Delivery-Policy'auto' | 'verified' | 'official'

Per-request Delivery policy. Overrides the API key and Workspace defaults. Auto tries TokenLab Verified first and may switch once to Official only before output, request acceptance, or persistent resource creation.

Idempotency-Keystring

Client-generated key for idempotent REST task creation. Under the same TokenLab API credential, reusing the same key with the same JSON body returns the original cgt task ID; reusing it with a different body returns 409. Keep the credential, key, and request body unchanged when retrying after a timeout or disconnect.

Request body

modelstring required

Seedance model or endpoint identifier. TokenLab maps supported Seedance 2.0 identifiers to the matching platform model.

ratio'16:9' | '4:3' | '1:1' | '3:4' | '9:16' | '21:9' | 'adaptive'

Output aspect ratio. Defaults to adaptive when omitted.

resolution'480p' | '720p' | '1080p'

Requested output resolution. Model-specific availability still applies.

generate_audioboolean

Whether to generate synchronized audio. The official default is false.

return_last_frameboolean

Return the final frame URL when supported.

watermarkboolean
seedinteger

Random seed. -1 lets the model choose a seed. Accepted on a best-effort basis where supported by the model.

execution_expires_afterinteger

Task execution expiration window in seconds.

safety_identifierstring

Stable caller-side safety identifier.

service_tier'default' | 'flex'

default is accepted. flex is rejected for Seedance 2.0 compatibility tasks because the selected model family does not support it here.

draftboolean

draft=true is not supported for Seedance 2.0 compatibility tasks and is rejected.

framesinteger

Not supported for Seedance 2.0 compatibility tasks. Use duration instead.

camera_fixedboolean

camera_fixed=true is not supported for Seedance 2.0 compatibility tasks. false is accepted as a no-op.

callback_urlstring uri

Public HTTP(S) endpoint notified by POST whenever status changes. The body is identical to the get-task response. queued, running, succeeded, failed, and expired are delivered. For succeeded and failed, a delivery without success within 5 seconds is retried up to three times.

Example request

{
  "model": "doubao-seedance-2-0-260128",
  "resolution": "720p"
}

Response

Task created

idstring required

Example response

{
  "id": "cgt-20260102030405-a1b2c"
}

Changes

No recorded changes to this operation across all 1 revision of this API.