Ark Seedance: Create Video Task

Submit a native Volcengine Ark Seedance async video job. Use a video API key from the Portal (ordinary keys cannot create video tasks).

See also: Get task status · Asset library

Endpoint

POST /api/v3/contents/generations/tasks

Auth

Authorization: Bearer sk-YOUR_VIDEO_API_KEY

Field	Required	Description
model	yes	A Seedance model on your allowlist (may be more than one; see group_name on Models)
content	yes	Native Ark content array (text / image / asset://…)

Use asset://<asset_id> only after ingest via the asset library. The Portal does not create tasks.

Wallet reserve uses the official token formula, then video-key quota. Success settles total_tokens × that resolution’s retail (no safety factor). Asset OpenAPI calls are not billed. pending_rebuild waits up to 2 hours for assets to become Active.

Reserve estimate: (input_sec + output_sec) × width × height × fps / 1024. Empty resolution/quality selects 720p. A request that does not match a priced band returns 400 (no silent 720p price fallback). Missing input-video Duration uses the model’s configured default seconds (5). Default fps is 24.

The create response id is prefixed with yq_ (platform task id, not Ark task_ / cgt-). Use that id for get/cancel.

Cancel only pending_rebuild via POST /api/v3/contents/generations/tasks/{id}/cancel. Running tasks cannot be cancelled.