视频生成 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.5480p / 720p / 1080p4–30 秒文生视频、参考生视频、首尾帧
toks/seedance_2.5_draft480p4–30 秒文生视频、参考生视频、首尾帧
toks/seedance_2.0720p / 1080p / 4K4–15 秒文生视频、参考生视频、首尾帧
toks/seedance_2.0_fast720p4–15 秒文生视频、参考生视频、首尾帧
toks/seedance_2.0_mini720p4–15 秒文生视频、参考生视频、首尾帧

模型名必须带渠道前缀 toks/。前缀用于把请求路由到视频供应商渠道,去掉前缀会被判定为未知模型。

创建参数

参数类型说明
modelstring必填,带上表中的完整模型名,含 toks/ 前缀
promptstring文生视频必填;参考生视频可省略
resolutionstring必填,取值见上表,注意 4k 只对 seedance_2.0 有效
durationinteger必填,整数秒,范围按模型判定
ninteger可选,1–4,默认 1
sizestring可选,画幅比例,如 16:9、9:16、1:1;不接受像素宽高
modestring可选,t2v / m2v / first_last_frame,省略时按入参自动推断
first_framestring首尾帧模式必填,公网 URL 或 Data URL
last_framestring可选尾帧,必须与 first_frame 同时出现
reference_imagesstring[]参考生视频用,最多 9 个
reference_videosstring[]参考生视频用,最多 3 个
reference_audiosstring[]参考生视频用,最多 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 状态。

错误与重试

HTTPtype说明
400invalid_request_error参数不合法,如缺 model、resolution、时长越界、包含不支持的字段
400video_request_rejected服务端拒绝创建,如模型无定价、渠道未启用
402insufficient_balance余额不足以覆盖本次冻结额度
404video_task_not_found任务不存在或不属于当前 Key
415—Content-Type 不是 application/json
429quota_exhaustedKey 额度或限流触顶

创建结果不明确时不要自动重试,以免产生重复任务和重复扣费;先按响应体里的任务 ID 查询,确认未受理后再重新提交。

价格(每秒)

价格为额度单价,人民币按 1 美元额度约合 0.25 元估算。实际扣费 = 单价 × 秒数 × 成功条数。

每一档都是厂商官网牌价(元/秒)先按 1 美元额度 = 0.25 元折算成挂牌单价,再乘 0.75 的折扣系数,因此相对官网牌价固定便宜 25%。

模型480p720p1080p4K
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 条;批量任务请自行控制并发。
  • 上游结果链接有有效期,过期后无法再取回成片。

本页内容