GET
视频内容获取

简介

视频内容获取接口 /v1/videos/{task_id}/content 用于获取已完成任务的视频文件本体(返回原始的 video/mp4 字节流),服务端会从上游拉取并把视频数据转发给你。 与你手里的几个接口的关系:
  • 部分渠道的查询响应会直接返回视频 url,可直接下载;
  • 本接口适合:上游返回的是 data: URL、地址带签名易过期、或你希望由服务端统一代理转发视频的场景;
  • 也适用于通过各种入口(统一视频接口、OpenAI 视频接口、Seedance/Kling/即梦)提交的任务,只要任务已成功。

认证

string
必填
Bearer Token,如 Bearer sk-xxxxxxxxxx

请求

GET https://api.shengmoai.com/v1/videos/{task_id}/content
string
必填
视频任务 ID,由提交接口返回(task_ 前缀)

响应

成功时返回视频文件本体(不是 JSON),Content-Typevideo/mp4,并带有 Cache-Control: public, max-age=86400 任务尚未完成时返回:
任务不存在时返回 404,失败原因以查询接口的 status / error 为准。

使用示例

下载保存文件

前端播放

浏览器拿到的是完整 mp4 字节流,可以直接作为 <video> 的源:
前端直接使用需要在请求头携带 Authorization;如需公开播放,请由业务后端代拉后再输出。

注意事项

  • 该接口只返回已完成任务的视频;任务还在排队/生成时请先轮询状态。
  • 视频内容来自上游存储,可能较大(数 MB ~ 上百 MB),下载与转存请考虑耗时与并发。
  • 文件会缓存 24 小时(max-age=86400),重复请求会命中缓存,适合测试与调试。

相关接口

视频生成总览

异步流程、入口选择与状态对照

OpenAI 视频接口

/v1/videos 系列:提交、查询与 Remix