Seedance 是字节跳动视频生成模型族。在 AiSDK 里,推荐通过统一视频入口调用,而不是直接使用上游私有路径。
AiSDK 推荐入口
- 提交任务:
POST /v1/videos
- 兼容旧路径:
POST /v1/video/generations
- 查询任务:
GET /v1/videos/{task_id}
- 获取结果:
GET /v1/videos/{task_id}/content
如果你们历史客户端已经在使用 /v1/video/generations,可以继续兼容;新接入建议统一走 /v1/videos。
提交任务
请求参数
ratio、aspect_ratio、resolution、fps 这些字段在代码里已有识别与计费链路支持,但是否被最终上游接受,仍取决于你当前绑定的具体渠道。
AiSDK 统一视频入口提交后,先返回任务摘要。典型格式如下:
查询任务
GET /v1/videos/{task_id}
典型查询结果如下:
视频输出地址位于 output.video_url,不是 metadata.url。
下载结果
如果你希望通过平台代理地址直接下载最终视频:
任务状态
接入建议
- 对外请优先使用平台公开模型名,不要把上游原始模型名直接写死到客户端。
- 第一次接入建议先只传
model + prompt 跑通,再逐步补 duration、ratio、resolution。
- 如果任务能提交但始终失败,优先排查当前 token 所属分组是否真的开放了这个 Seedance 模型。