One continuous four-second macro tracking shot across a worn oak worktable. A palm-sized fictional brass clockwork beetle with six articulated legs follows one painted-free curved path between three plain wooden blocks. It starts still, walks around the first block, makes one quick right-left correction between the next two blocks, then stops beside a small steel washer. The camera tracks low beside it at constant distance. Preserve the beetle's single oval shell, six legs, exposed rear winding key, scale, route direction, block positions, table grain, and warm workshop light. Use coherent leg contacts, stable body mechanics, and no sliding. Synchronized audio: fine gear ticks, six-leg taps on wood, and one quiet metal click at the stop. No cuts, no people, no other insects, no readable text, no logos, no brands, no products, no advertising, no watermark.
Seedance 2.0 Fast 文本生成视频
seedance-2.0-fast/text-to-videoSeedance 2.0 Fast 文本生成视频接口无需源素材,可把场景描述生成 4–15 秒视频。提示词可分别说明主体、动作、镜头、光线、氛围和声音,Fast 提供 480p 与 720p,并采用更低的当前积分费率。
输入
高级参数
生成音频
请求模型随视频生成音轨。
返回最后一帧
保留视频主结果,并把最后一帧作为额外文件返回。
联网辅助
发送可选的联网辅助生成字段。
输出
等待运行生成文件会显示在这里
设置输入、选择时长,然后运行异步视频任务。
继续使用
示例
REST API
快速开始
完成认证,提交最小合法的文本生成视频请求,再取得异步视频结果。
连接 Vidgo API
创建 API 密钥,仅保存在服务端,并通过 Bearer Header 发送。
- 端点
- POST
https://api.vidgo.ai/api/generate/submit - 认证
- Authorization: Bearer VIDGO_API_KEY
提交一个生成任务
发送精确模型 ID 和当前模式必填字段,成功后立即取得 task_id。
curl --request POST \
--url "https://api.vidgo.ai/api/generate/submit" \
--header "Authorization: Bearer $VIDGO_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"model": "seedance-2.0-fast/text-to-video",
"callback_url": "https://httpbin.org/post",
"input": {
"prompt": "One continuous four-second macro tracking shot across a worn oak worktable. A palm-sized fictional brass clockwork beetle with six articulated legs follows one painted-free curved path between three plain wooden blocks. It starts still, walks around the first block, makes one quick right-left correction between the next two blocks, then stops beside a small steel washer. The camera tracks low beside it at constant distance. Preserve the beetle's single oval shell, six legs, exposed rear winding key, scale, route direction, block positions, table grain, and warm workshop light. Use coherent leg contacts, stable body mechanics, and no sliding. Synchronized audio: fine gear ticks, six-leg taps on wood, and one quiet metal click at the stop. No cuts, no people, no other insects, no readable text, no logos, no brands, no products, no advertising, no watermark.",
"duration": 4,
"resolution": "480p",
"aspect_ratio": "16:9",
"generate_audio": true,
"seed": 26082703
}
}'等待结果
仅轮询 not_started 或 running,或使用 callback_url 接收平铺终态对象。
跟踪状态
GET https://api.vidgo.ai/api/generate/status/BTTXD9SZOQ62OOWH初始轮询间隔约 2 秒,长任务逐步退避并设置超时。finished 与 failed 都是终态。网络失败、请求超时和任务失败应分别处理;callback_url 使用同一请求契约。
not_startedrunningfinishedfailed{
"code": 200,
"data": {
"task_id": "BTTXD9SZOQ62OOWH",
"status": "running",
"created_time": "2026-08-27T14:22:42"
}
}{
"code": 200,
"data": {
"task_id": "BTTXD9SZOQ62OOWH",
"status": "finished",
"progress": 100,
"created_time": "2026-08-27T14:22:42",
"error_message": null,
"files": [
{
"file_type": "video",
"file_url": "https://cdn.vidgo.ai/apis/models/bytedance/seedance-2.0-fast/text-to-video/v1/output.mp4"
}
]
}
}完整可运行示例
示例包含 HTTP 与业务码检查、task_id 校验、退避轮询、超时、终态与结果提取。
set -euo pipefail
: "${VIDGO_API_KEY:?Set VIDGO_API_KEY in your environment}"
REQUEST_BODY=$(cat <<'JSON'
{
"model": "seedance-2.0-fast/text-to-video",
"callback_url": "https://httpbin.org/post",
"input": {
"prompt": "One continuous four-second macro tracking shot across a worn oak worktable. A palm-sized fictional brass clockwork beetle with six articulated legs follows one painted-free curved path between three plain wooden blocks. It starts still, walks around the first block, makes one quick right-left correction between the next two blocks, then stops beside a small steel washer. The camera tracks low beside it at constant distance. Preserve the beetle's single oval shell, six legs, exposed rear winding key, scale, route direction, block positions, table grain, and warm workshop light. Use coherent leg contacts, stable body mechanics, and no sliding. Synchronized audio: fine gear ticks, six-leg taps on wood, and one quiet metal click at the stop. No cuts, no people, no other insects, no readable text, no logos, no brands, no products, no advertising, no watermark.",
"duration": 4,
"resolution": "480p",
"aspect_ratio": "16:9",
"generate_audio": true,
"seed": 26082703
}
}
JSON
)
SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
--request POST \
--url "https://api.vidgo.ai/api/generate/submit" \
--header "Authorization: Bearer $VIDGO_API_KEY" \
--header "Content-Type: application/json" \
--data "$REQUEST_BODY")
TASK_ID=$(printf '%s' "$SUBMIT_RESPONSE" | jq -r '.data.task_id // .task_id // empty')
if [ -z "$TASK_ID" ]; then
printf 'Submit response did not include task_id:
%s
' "$SUBMIT_RESPONSE" >&2
exit 1
fi
while true; do
STATUS_RESPONSE=$(curl --silent --show-error --fail-with-body \
--url "https://api.vidgo.ai/api/generate/status/BTTXD9SZOQ62OOWH" \
--header "Authorization: Bearer $VIDGO_API_KEY")
STATUS=$(printf '%s' "$STATUS_RESPONSE" | jq -r '.data.status // .status // empty')
case "$STATUS" in
finished)
printf '%s' "$STATUS_RESPONSE" | jq -r '(.data.files // .files // [])[]?.file_url'
break
;;
failed)
printf '%s' "$STATUS_RESPONSE" | jq -r '.data.error_message // .error_message // "Generation failed"' >&2
exit 1
;;
not_started|running)
sleep 2
;;
*)
printf 'Unexpected task status: %s
' "$STATUS" >&2
exit 1
;;
esac
done请求参数
model 与可选 callback_url 位于顶层;生成字段位于 input,额外属性会被拒绝或忽略。
| 字段 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| model | string | 是 | — | 必须为 seedance-2.0-fast/text-to-video. |
| callback_url | string (URL) | 否 | — | 接收终态任务对象的公开 HTTP(S) 地址。 |
| input | object | 是 | — | 只包含当前模式公开字段。 |
| input.prompt | string | 必填 | — | trim 后 1–20,000 个字符;体验区提供示例提示词。 |
| input.duration | integer | 必填 | — | 4–15 的整数,包含边界;体验区默认 5 秒。 |
| input.resolution | string | 必填 | 720p | 支持 480p、720p;体验区默认 720p。 |
| input.aspect_ratio | string | 可选 | 16:9 | 支持 auto、21:9、16:9、4:3、1:1、3:4、9:16;体验区默认 16:9。 |
| input.generate_audio | boolean | 可选 | true | boolean;体验区默认并显式发送 true。 |
| input.return_last_frame | boolean | 可选 | false | boolean;体验区默认并显式发送 false。 |
| input.web_search | boolean | 可选 | false | boolean;体验区默认并显式发送 false。 |
| input.seed | integer | 可选 | — | 整数;公开契约未声明范围,留空时省略。 |
| 不接受的媒体字段 | — | — | — | image_urls, start_image_url, end_image_url, reference_*_urls, video_url, video_urls |
响应字段
提交响应提供任务身份,状态响应提供进度、全部结果文件或失败信息。
| 字段 | 类型 | 说明 |
|---|---|---|
| code | integer | 业务返回码;成功兼容 0 与 200。 |
| message | string | 可选的响应或错误说明。 |
| data.task_id | string | 提交后用于查询状态的任务 ID。 |
| data.status | string | not_started, running, finished, or failed. |
| data.created_time | string | 任务创建时间。 |
| data.progress | integer | 已报告的完成百分比。 |
| data.files[] | array | 按返回顺序排列的全部结果文件。 |
| data.files[].file_url | string | 结果文件直链。 |
| data.files[].file_type | string | video、image 或其他公开类型。 |
| data.files[].watermark_url | string | null | 后端提供时的水印文件 URL。 |
| data.error_message | string | null | 失败终态的错误说明。 |
任务生命周期
not_started 与 running 为非终态;finished 与 failed 为终态。
not_started请求已接收,等待执行。
running生成进行中,按退避策略继续轮询。
finished成功终态,读取全部 files。
failed失败终态,读取 error_message 并停止。
轮询与错误
- 认证401 表示 Bearer Key 缺失或无效,修正后再请求。
- 校验400 表示请求违反当前端点契约,按字段错误修正。
- 余额不足余额不足与普通 400 分开提示所需积分和美元金额。
- 轮询与超时约 2 秒开始并逐步退避;网络失败和客户端超时不是任务 failed。
- 终态与 callbackfinished 或 failed 立即停止;callback_url 可接收同一任务的平铺终态对象。
模型规格
| 规格 | 取值 | 说明 |
|---|---|---|
| 输入模式 | 纯文本 | 拒绝全部媒体字段。 |
| 输出 | 异步视频任务 | 可能返回多个文件,按顺序全部展示。 |
| 分辨率 | 480p / 720p | Fast 不接受 1080p 或 4K。 |
| 时长 | 4–15 秒整数 | 包含边界值。 |
| 画面比例 | 7 种 | Auto 加六种固定比例。 |
| 计费依据 | 输出秒数 | 480p: 14 credits ($0.070)/s; 720p: 28 credits ($0.140)/s |
Seedance 2.0 Fast 文本生成视频
Seedance 2.0 Fast 文本生成视频接口无需源素材,可把场景描述生成 4–15 秒视频。提示词可分别说明主体、动作、镜头、光线、氛围和声音,Fast 提供 480p 与 720p,并采用更低的当前积分费率。
为什么选择这个接口?
纯文本即可开始。无需图片、视频或音频素材即可描述完整镜头。
当前费率更低。480p 与 720p 适合成本敏感的迭代和批量试验。
时长控制连续。可选择 4–15 秒范围内的任意整数,不受少数预设时长限制。
音频与末帧可控。可显式请求生成音轨、返回末帧,并保留联网辅助与 seed 控制。
参数
| 参数 | 要求 | 说明 |
|---|---|---|
| prompt | 必填 | trim 后 1–20,000 个字符;体验区提供示例提示词。 |
| duration | 必填 | 4–15 的整数,包含边界;体验区默认 5 秒。 |
| resolution | 必填 | 支持 480p、720p;体验区默认 720p。 默认值 720p480p |
| aspect_ratio | 可选 | 支持 auto、21:9、16:9、4:3、1:1、3:4、9:16;体验区默认 16:9。 默认值 16:99:161:121:94:33:4auto |
| generate_audio | 可选 | boolean;体验区默认并显式发送 true。 默认值 true |
| return_last_frame | 可选 | boolean;体验区默认并显式发送 false。 默认值 false |
| web_search | 可选 | boolean;体验区默认并显式发送 false。 默认值 false |
| seed | 可选 | 整数;公开契约未声明范围,留空时省略。 |
使用方法
定义主体与场景写清谁在什么环境中出现,以及必须保持的细节。
描述动作用具体动词说明主体运动,并与镜头移动分开书写。
设置输出选择 480p、720p、4–15 秒时长和适用画面比例。
检查高级参数确认音频、末帧、联网辅助与 seed 是否符合本次任务。
提交并跟踪运行请求,再轮询任务 ID 或处理终态 callback。
价格
1 积分 = $0.005。总积分等于输出时长乘以所选分辨率费率。高级参数、图片数与音频数不改变当前公式。
| 计费项 | 费率 | 说明 |
|---|---|---|
| 480p 输出 | 14 积分/输出秒 | $0.070/秒;5 秒为 70 积分($0.350)。 |
| 720p 输出 | 28 积分/输出秒 | $0.140/秒;5 秒为 140 积分($0.700)。 |
适用场景
概念短片把书面场景转为可评审的动态概念。
社交视频按横屏、方形或竖屏构图生成短内容。
广告分镜测试单个广告镜头的动作、光线和节奏。
电影或游戏预演在制作前验证调度、镜头移动和氛围。
实用技巧
- 按主体与场景、动作、镜头、光线氛围、声音意图的顺序写提示词。
- 纯文本模式只安排一个主要动作,短片更容易保持可读。
- 用具体运动动词,并把主体运动与镜头运动分开。
- 先确定画面比例和构图,再描述主体在画面中的位置。
- 需要节奏变化时,说明开场、发展与结束三个动作节点。
注意事项
- 该端点拒绝所有媒体字段。
- resolution 在公开 OpenAPI 中为必填,示例与体验区始终显式发送。
- 体验区上传策略是 JPEG/PNG/WebP 30 MB、MP4/WebM/MOV 50 MB、MP3/WAV 15 MB,不代表完整上游文件契约。
- Fast 只接受 480p 与 720p,不支持 1080p 或 4K。
- 任务为异步流程,只在 not_started 与 running 时继续轮询。
关于 Seedance 2.0 Fast 文本生成视频 API 的常见问题
Seedance 2.0 Fast 文本生成视频 API 是什么?
Seedance 2.0 Fast 是 ByteDance Seedance 模型。当前文本生成视频端点接收纯文本提示词,不需要源素材,并按照文档中的 REST 请求结构返回异步视频生成任务。
如何调用 Seedance 2.0 Fast 文本生成视频 API?
通过 Authorization: Bearer VIDGO_API_KEY 调用 POST /api/generate/submit。成功响应包含 task_id,可用于统一状态查询。
Seedance 2.0 Fast 文本生成视频 API 如何计费?
按输出秒数乘以分辨率费率计算。480p: 14 credits ($0.070)/s; 720p: 28 credits ($0.140)/s。
Seedance 2.0 Fast 文本生成视频 API 接受哪些输入?
接受 1–20,000 字符提示词、4–15 秒整数、480p、720p、七种画面比例和可选高级字段,不接受媒体输入。
如何获取生成视频?
轮询 GET /api/generate/status/{task_id},或提交 callback_url。只在 not_started、running 时继续;finished 后从 data.files[].file_url 读取全部结果,failed 时停止并处理错误。
应该选择哪个 Seedance 2.0 端点?
无源素材选择 Text,首帧或首尾帧选择 Image,需要图片、视频或音频共同引导时选择 Reference。Standard 提供到 4K 的更多分辨率,Fast 仅 480p/720p 并采用较低当前费率。


