Skip to main content
GET
/
v1
/
videos
/
{video_id}
检索视频
curl --request GET \
  --url https://api.deerapi.com/v1/videos/{video_id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "<string>",
  "size": "<string>",
  "error": null,
  "model": "<string>",
  "object": "<string>",
  "status": "<string>",
  "seconds": "<string>",
  "progress": 123,
  "created_at": 123,
  "expires_at": 123,
  "completed_at": 123,
  "remixed_from_video_id": null
}
当前页只用于查询 创建视频（官方格式） 或 混编视频（官方格式） 产生的任务。

​
轮询时重点看什么

  • status：最重要的状态字段，通常会在 queued、in_progress、completed、failed 之间变化。
  • progress：可用于前端进度提示，但不应该拿它当严格的计费或超时依据。
  • error：任务失败时的原因。
  • expires_at：可下载资源过期时间。进入终态后请尽快下载。

​
推荐轮询方式

  1. 创建任务后保存 video_id。
  2. 每隔 10 到 20 秒查询一次当前页。
  3. status=completed 后再去 下载视频（官方格式）。
  4. status=failed 时优先看 error，通常是内容审核、输入参考图不合规或上游生成失败。

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

OpenAI 官方最新文档同样推荐通过 GET /videos/{video_id} 查看任务状态，也提到可以用 webhook 收到事件通知。DeerAPI 当前页重点文档化的是最通用的轮询方案，因为它不要求额外配置官方项目级 webhook。

​
常见限制

  • video_id 必须来自官方格式创建或官方格式混编。
  • 如果任务还在 queued 或 in_progress，不要提前调用下载接口。
  • 一旦 expires_at 临近或已到期，之前的下载资产可能失效，需要尽快保存或重新生成。

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

​
id
string
required
​
size
string
required
​
error
null
required
​
model
string
required
​
object
string
required
​
status
string
required
​
seconds
string
required
​
progress
integer
required
​
created_at
integer
required
​
expires_at
integer
required
​
completed_at
integer
required
​
remixed_from_video_id
null
required