视频专用

天枢通过 视频专用 分组提供 Seedance、Veo、Kling、MiniMax、Grok 等多家视频模型，统一走同一套视频接口调用。

计费分两种：按条 / 按秒

选型时最需要留意的就是这一点：

• 按条计费：一次请求一个价，与时长无关。要出长片更划算。
• 按秒计费：单价 × 时长。短片更便宜，长片按实际用量付费。

模型广场 的卡片上会直接标出是 / 条 还是 / 秒；左侧「定价类型」筛选里也可以只看其中一类。

单价低不等于总价低

一个标 ¥0.375 / 秒 的模型，拍 15 秒是 ¥5.625；另一个标 ¥4.35 / 条 的模型不论多长都是 ¥4.35。务必按你实际要的时长换算之后再比。

怎么调用

视频是异步任务：先提交拿到 task_id，再轮询结果。需使用 视频专用 分组的令牌。

curl 'https://tian-shu.net/v1/videos' \
  -H 'Authorization: Bearer 你的 视频专用 分组令牌' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "seedance-2.0-fast",
    "prompt": "雨夜霓虹街道，镜头缓慢推进，电影感光影",
    "aspect_ratio": "16:9"
  }'

提交后轮询 GET /v1/videos/{task_id}，status 变为 completed 即可取回成片。

取片

status 变为 completed 后，从响应的 metadata.url 下载成片。该地址固定为：

curl -L 'https://tian-shu.net/v1/videos/{task_id}/content' \
  -H 'Authorization: Bearer 你的 视频专用 分组令牌' \
  -o video.mp4

返回 video/mp4。

成片保留期有限

请在生成完成后尽快下载并自行保存。超过保留期后该地址将不再可用。

失败时响应不含 metadata，只返回 error.message，且不计费。

每个模型的参数不一样

不同模型支持的时长、分辨率、参考图/首尾帧能力差别很大。在模型广场点卡片上的「文档」按钮，可以看到该模型专属的接口说明、参数表和可直接复制的请求示例，详见 模型广场使用。