Guides · 비디오 생성

비디오 생성

Generate cinematic video clips using Seedance 2.0.

Portrait 를 입력으로 사용

Reference portraits in video generation by passing asset://<asset-id>. See Portrait guide.

Generate short video clips from text prompts or reference images using Seedance models.

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	}'

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.

model — "seedance-2.0", "seedance-2.0-fast", or "seedance-1.5-pro"
prompt — text description of the desired video
ratio — "16:9", "9:16", "4:3", "3:4", "21:9", "1:1", or "adaptive"
duration — length in seconds; -1 lets the model choose automatically
resolution — "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 — pass asset://<asset_id> after onboarding (see Portrait guide); public URLs of real-person images may be rejected upstream for deepfake / consent compliance.

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