Guides · Video Generation
Video Generation
Generate cinematic video clips using the Seedance 2.0 model.
Using Portrait as input
Reference virtual or real-person portraits in video generation by passing asset://<asset-id> as multimodal input. See Portrait guide for the end-to-end onboarding flow.
Overview
Generate short cinematic video clips from text prompts or reference images using Seedance models.
Creating a video
Submit a video generation task using the Videos API:
cURL
| 1 | curl https://api.alltoken.ai/v1/videos/generations -H "Authorization: Bearer $ALLTOKEN_API_KEY" -H "Content-Type: application/json" -d '{ |
| 2 | "model": "seedance-2.0", |
| 3 | "prompt": "A serene mountain lake at sunrise, cinematic 4K", |
| 4 | "ratio": "16:9", |
| 5 | "duration": 5, |
| 6 | "resolution": "720p" |
| 7 | }' |
Supported models
| Model | asset:// portrait reference |
|---|---|
seedance-2.0 | ✅ Supported |
seedance-2.0-fast | ✅ Supported |
seedance-1.5-pro | ❌ Not supported (upstream rejects). Use plain image URLs only. |
See Portrait guide for how to obtain an asset_id.
Parameters
model—"seedance-2.0","seedance-2.0-fast", or"seedance-1.5-pro"prompt— text description of the desired videoratio—"16:9","9:16","4:3","3:4","21:9","1:1", or"adaptive"duration— length in seconds;-1lets the model choose automaticallyresolution—"480p","720p", or"1080p"content— multimodal input array for image-to-video or references, for example{ "type": "image_url", "image_url": { "url": "..." }, "role": "first_frame" }. Images containing real human faces must go through Portrait first — passasset://<asset_id>after onboarding (see Portrait guide); public URLs of real-person images may be rejected upstream for deepfake / consent compliance.
Checking task status
Video generation is asynchronous. Poll for status:
cURL
$curl https://api.alltoken.ai/v1/videos/generations/{task_id} -H "Authorization: Bearer $ALLTOKEN_API_KEY"The response includes status (queued, processing, completed, failed, expired, or cancelled) and a download URL when complete.
Cancel a task
Cancel a queued or processing task:
cURL
$curl -X POST https://api.alltoken.ai/v1/videos/generations/{task_id}/cancel -H "Authorization: Bearer $ALLTOKEN_API_KEY"Tasks already completed, failed, or cancelled cannot be cancelled.