Skip to main content
GET
/
v1
/
videos
/
{video_id}
/
content
下载视频
curl --request GET \
  --url https://api.deerapi.com/v1/videos/{video_id}/content \
  --header 'Authorization: Bearer <token>'
{
  "message": "<string>",
  "data": {
    "error": {
      "code": null,
      "message": "<string>",
      "param": null,
      "type": "<string>"
    }
  }
}
当前页只用于下载已经完成的官方格式视频任务结果。

​
默认下载什么

不传 variant 时，默认下载最终 MP4 视频。 如果你只是第一次接入，建议先保持默认，不要额外传 variant。

​
variant 怎么选

  • video：默认值，返回最终 MP4。
  • thumbnail：返回缩略图，适合列表页、作品预览卡片。
  • spritesheet：返回拼接预览图，适合时间轴预览或拖动查看。

​
查询和下载的顺序

  1. 先通过 检索视频（官方格式） 确认 status=completed。
  2. 再调用当前页下载内容。
如果你跳过查询，直接下载最常见的结果就是 not found、任务未完成，或者资源已经过期。

​
这和 OpenAI 官方文档有什么差异

OpenAI 官方最新文档同样把当前页定义为下载二进制内容的接口，并额外说明 thumbnail 与 spritesheet 两种派生资源。DeerAPI 保留了这套语义，只是统一了域名与鉴权方式。

​
常见限制

  • 成功响应是二进制内容，不是 JSON。
  • 根据 OpenAI 官方最新视频生成指南，下载资源的有效期通常只有大约 1 小时。完成后请尽快保存。
  • video_id 必须来自官方格式链路；tech 兼容任务不要默认拿当前页当成唯一下载方案。

Authorizations

​
Authorization
string
header
required

Bearer token authentication. Use your DeerAPI key.

Path Parameters

​
video_id
string
required

要下载的video_id

Response

200 - application/json

Successful Response

​
message
string
required
​
data
object
required