Skip to main content
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

提交任务

请求参数

ratioaspect_ratioresolutionfps 这些字段在代码里已有识别与计费链路支持,但是否被最终上游接受,仍取决于你当前绑定的具体渠道。

示例

响应

AiSDK 统一视频入口提交后,先返回任务摘要。典型格式如下:

查询任务

GET /v1/videos/{task_id} 典型查询结果如下: 视频输出地址位于 output.video_url,不是 metadata.url

下载结果

如果你希望通过平台代理地址直接下载最终视频:

任务状态

接入建议

  • 对外请优先使用平台公开模型名,不要把上游原始模型名直接写死到客户端。
  • 第一次接入建议先只传 model + prompt 跑通,再逐步补 durationratioresolution
  • 如果任务能提交但始终失败,优先排查当前 token 所属分组是否真的开放了这个 Seedance 模型。