视频生成 API
使用视频生成 API 按秒计费创建 Seedance 视频任务,并通过任务状态接口获取成片结果。
GetToken 视频生成 API 提供文生视频、图生视频与首尾帧视频能力,模型来自火山方舟 Seedance 系列,每一档都按厂商官网牌价固定 75 折结算。视频采用异步任务:先创建任务拿到任务 ID,再轮询状态,任务完成后从结果字段读取上游返回的视频文件地址。
所有请求都使用 service_type=video_api 的专用 API Key。视频 Key 与普通文本 Key、生图 Key 分开管理,不能混用;控制台「视频生成 API」页面可直接创建。计费走账户余额,按秒计价,不消耗订阅额度。
完整产品说明与实时报价见站点「视频生成 API」页面:
https://gettoken.dev/video-api接口
- 服务地址:
https://api.clawto.link(备用线路https://api.gettoken.dev) - 端点:
POST /v1/videos(创建任务,也可写成/v1/videos/generations)GET /v1/videos/{task_id}(查询任务状态与结果)
- 鉴权:
Authorization: Bearer <视频 API Key> - 请求体:
Content-Type: application/json
视频供应商通道只支持创建与状态查询。编辑、续写、内容代理下载都不在支持范围内,任务完成后请直接使用结果字段里的上游地址。
模型
模型名(model) | 分辨率 | 单条时长 | 输入方式 |
|---|---|---|---|
toks/seedance_2.5 | 480p / 720p / 1080p | 4–30 秒 | 文生视频、参考生视频、首尾帧 |
toks/seedance_2.5_draft | 480p | 4–30 秒 | 文生视频、参考生视频、首尾帧 |
toks/seedance_2.0 | 720p / 1080p / 4K | 4–15 秒 | 文生视频、参考生视频、首尾帧 |
toks/seedance_2.0_fast | 720p | 4–15 秒 | 文生视频、参考生视频、首尾帧 |
toks/seedance_2.0_mini | 720p | 4–15 秒 | 文生视频、参考生视频、首尾帧 |
模型名必须带渠道前缀 toks/。前缀用于把请求路由到视频供应商渠道,去掉前缀会被判定为未知模型。
创建参数
| 参数 | 类型 | 说明 |
|---|---|---|
model | string | 必填,带上表中的完整模型名,含 toks/ 前缀 |
prompt | string | 文生视频必填;参考生视频可省略 |
resolution | string | 必填,取值见上表,注意 4k 只对 seedance_2.0 有效 |
duration | integer | 必填,整数秒,范围按模型判定 |
n | integer | 可选,1–4,默认 1 |
size | string | 可选,画幅比例,如 16:9、9:16、1:1;不接受像素宽高 |
mode | string | 可选,t2v / m2v / first_last_frame,省略时按入参自动推断 |
first_frame | string | 首尾帧模式必填,公网 URL 或 Data URL |
last_frame | string | 可选尾帧,必须与 first_frame 同时出现 |
reference_images | string[] | 参考生视频用,最多 9 个 |
reference_videos | string[] | 参考生视频用,最多 3 个 |
reference_audios | string[] | 参考生视频用,最多 3 个 |
mode 的推断规则:带 first_frame 时按 first_last_frame 处理;带任一 reference_* 时按 m2v 处理;都不带时按 t2v 处理。
以下字段不受支持,出现即返回 400:quality、style、seed、negative_prompt、width、height、watermark、background、output_format。
参考媒体支持公网 HTTP/HTTPS 地址,或 data:image/png;base64,、data:image/jpeg;base64,、data:image/webp;base64, 形式的 Data URL。带账号密码的 URL 会被拒绝。
创建文生视频
curl --fail https://api.clawto.link/v1/videos \
-H "Authorization: Bearer YOUR_VIDEO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "toks/seedance_2.0_fast",
"prompt": "雨后的城市街道,镜头缓慢向前推进",
"resolution": "720p",
"duration": 5,
"size": "16:9"
}'创建成功返回 202,响应体包含任务 ID 与轮询地址:
{
"id": "vsvid_2f6c1d0e-7b1a-4c62-9d05-8f9a1c3e5b70",
"object": "video",
"model": "seedance_2.0_fast",
"status": "in_progress",
"duration": 5,
"resolution": "720p",
"n": 1,
"poll_url": "/v1/videos/vsvid_2f6c1d0e-7b1a-4c62-9d05-8f9a1c3e5b70",
"reserved_usd": 12.0,
"charged_usd": 0,
"refunded_usd": 0
}reserved_usd 是提交时冻结的额度,等于单价 × 秒数 × 条数;charged_usd 在任务完成后才写入实际扣费。
创建首尾帧视频
curl --fail https://api.clawto.link/v1/videos \
-H "Authorization: Bearer YOUR_VIDEO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "toks/seedance_2.5",
"prompt": "让画面中的主体自然走向镜头",
"resolution": "720p",
"duration": 8,
"size": "16:9",
"first_frame": "https://example.com/first.png",
"last_frame": "https://example.com/last.png"
}'first_frame 与 last_frame 必须成对出现;只给尾帧会返回 400。
查询任务状态
curl --fail \
-H "Authorization: Bearer YOUR_VIDEO_API_KEY" \
https://api.clawto.link/v1/videos/vsvid_2f6c1d0e-7b1a-4c62-9d05-8f9a1c3e5b70状态取值:
| 状态 | 处理方式 |
|---|---|
queued / in_progress | 任务处理中,继续轮询 |
completed | 任务完成,读取 result 下载成片 |
failed | 任务失败,已冻结额度按失败退款 |
expired | 产物过期,不视为失败,需人工核对 |
建议每 5–10 秒查询一次。任务完成后响应体包含上游结果:
{
"id": "vsvid_2f6c1d0e-7b1a-4c62-9d05-8f9a1c3e5b70",
"object": "video",
"model": "seedance_2.0_fast",
"status": "completed",
"duration": 5,
"resolution": "720p",
"n": 1,
"poll_url": "/v1/videos/vsvid_2f6c1d0e-7b1a-4c62-9d05-8f9a1c3e5b70",
"reserved_usd": 12.0,
"charged_usd": 12.0,
"refunded_usd": 0,
"result": [
{
"url": "https://<供应商结果域名>/<对象路径>.mp4",
"download_url": "https://<供应商结果域名>/<对象路径>.mp4",
"file_name": "job_2f6c1d0e.mp4",
"bytes": 11017312,
"expires_at": 1794628614
}
]
}result 是数组,长度等于实际生成成功的条数。expires_at 是 Unix 秒级时间戳,过期后地址失效,请在任务完成后尽快转存到自己的存储。超过有效期仍请求状态会得到空结果或 expired 状态。
错误与重试
| HTTP | type | 说明 |
|---|---|---|
| 400 | invalid_request_error | 参数不合法,如缺 model、resolution、时长越界、包含不支持的字段 |
| 400 | video_request_rejected | 服务端拒绝创建,如模型无定价、渠道未启用 |
| 402 | insufficient_balance | 余额不足以覆盖本次冻结额度 |
| 404 | video_task_not_found | 任务不存在或不属于当前 Key |
| 415 | — | Content-Type 不是 application/json |
| 429 | quota_exhausted | Key 额度或限流触顶 |
创建结果不明确时不要自动重试,以免产生重复任务和重复扣费;先按响应体里的任务 ID 查询,确认未受理后再重新提交。
价格(每秒)
价格为额度单价,人民币按 1 美元额度约合 0.25 元估算。实际扣费 = 单价 × 秒数 × 成功条数。
每一档都是厂商官网牌价(元/秒)先按 1 美元额度 = 0.25 元折算成挂牌单价,再乘 0.75 的折扣系数,因此相对官网牌价固定便宜 25%。
| 模型 | 480p | 720p | 1080p | 4K |
|---|---|---|---|---|
seedance_2.5 | $2.01 | $4.53 | $11.22 | — |
seedance_2.5_draft | $2.01 | — | — | — |
seedance_2.0 | — | $2.97 | $7.44 | $15.15 |
seedance_2.0_fast | — | $2.40 | — | — |
seedance_2.0_mini | — | $1.50 | — | — |
折合人民币:seedance_2.0_mini 720p 为每秒 ¥0.375,一条 5 秒视频 ¥1.88;seedance_2.0_fast 720p 为每秒 ¥0.60,一条 5 秒视频 ¥3.00。
只列出当前可售的档位。上游采购成本高于官网牌价的档位暂时不开放,调用时按参数错误返回。
计费边界:
- 创建时按
单价 × 秒数 × 条数冻结额度,冻结金额显示在reserved_usd。 - 任务完成后按实际成功条数结算,
charged_usd不超过冻结金额。 failed全额退回冻结额度;unknown(创建超时、连接中断等)保留冻结,需人工核对后才结算。- 状态查询不重复计费。
注意事项
- 视频 Key 只能用于视频端点,用普通 Key 调用会返回 401。
- 视频扣费只走余额,不吃订阅套餐额度,请先确认余额充足。
- 一次请求最多生成 4 条;批量任务请自行控制并发。
- 上游结果链接有有效期,过期后无法再取回成片。