Documentation
Guides / 视频生成
Guides · 视频生成

视频生成

使用 Seedance 2.0 生成电影感短视频。

使用 Portrait 作为输入

在视频生成中通过 asset://<asset-id> 引用虚拟人或真人 Portrait。完整接入流程见 Portrait guide。

概述

使用 Seedance 模型，从文本提示词或参考图生成短视频。

创建视频

Submit a video generation task using the Videos API:

cURL
1curl 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 }'

支持的模型

模型asset:// Portrait 引用
seedance-2.0✅ 支持
seedance-2.0-fast✅ 支持
seedance-1.5-pro❌ 不支持（上游会拒绝）。只能使用普通图片 URL。

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" }. 包含真人面部的图片必须先走 Portrait：接入后传 asset://<asset_id>（见 Portrait guide）；真人图片公网 URL 可能因 deepfake / consent 合规被上游拒绝。

查询任务状态

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.

取消任务

取消 queued 或 processing 中的任务：

cURL
$curl -X POST https://api.alltoken.ai/v1/videos/generations/{task_id}/cancel   -H "Authorization: Bearer $ALLTOKEN_API_KEY"

已经 completed、failed 或 cancelled 的任务不能取消。