MetaMirror

通用视频接口 · OpenAI 格式

下载视频

下载生成成功的视频文件（mp4）。请求方式与 OpenAI 的 Retrieve video content 接口一致。

GEThttps://your-domain/v1/videos/{id}/content

请求参数

路径参数

idstring必填
视频 ID。

查询参数

variantstring默认值 video
下载的内容，只支持 video（视频本身）。

返回结果

成功时返回 mp4 文件，支持 Range 请求断点续传。视频存放在对象存储或其他地址时，返回 HTTP 302 跳转到视频地址：cURL 需要加 -L，OpenAI SDK 和 fetch 会自动跟随跳转。

  • 视频还没有生成完成（status 不是 completed）时返回 HTTP 409，错误码 video_not_ready。
  • 视频不存在或不属于当前账号时返回 HTTP 404。

查询视频返回的 video_url 也可以直接下载，不需要带 API Key，适合交给浏览器或播放器使用。