Skip to main content
GET
/
v1
/
videos
/
{video_id}
查询视频任务
curl --request GET \
  --url https://models.rivus.cn/v1/videos/{video_id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "video_691209aab0a08198a4e78870277f7e3d0215e09cec47a737",
  "object": "video",
  "created_at": 1762789802,
  "status": "processing",
  "model": "sora-2",
  "prompt": "百事可乐宣传片",
  "progress": 45,
  "seconds": "4",
  "size": "720x1280"
}
查询已创建的视频生成任务的当前状态、进度和结果。

​
查询视频任务

通过视频 ID 查询任务详情： 
curl "https://models.rivus.cn/v1/videos/$VIDEO_ID" \
  -H "Authorization: Bearer $TOKEN"

​
响应示例

任务进行中： 
{
  "id": "video_691209aab0a08198a4e78870277f7e3d0215e09cec47a737",
  "object": "video",
  "created_at": 1762789802,
  "status": "processing",
  "model": "sora-2",
  "prompt": "百事可乐宣传片",
  "progress": 45,
  "seconds": "4",
  "size": "720x1280"
}
任务完成： 
{
  "id": "video_691209aab0a08198a4e78870277f7e3d0215e09cec47a737",
  "object": "video",
  "created_at": 1762789802,
  "completed_at": 1762789891,
  "expires_at": 1762793491,
  "status": "completed",
  "model": "sora-2",
  "prompt": "百事可乐宣传片",
  "progress": 100,
  "seconds": "4",
  "size": "720x1280"
}

​
状态说明

  • queued：任务已排队，等待处理
  • processing：正在生成视频
  • completed：生成完成，可下载视频
  • failed：生成失败

​
响应字段说明

  • id：视频任务的唯一标识符
  • created_at：任务创建时间戳
  • completed_at：任务完成时间戳（仅在 completed 状态下存在）
  • expires_at：视频过期时间戳（仅在 completed 状态下存在）
  • progress：处理进度（0-100）
  • seconds：视频时长（字符串格式）
  • size：视频分辨率

​
下载视频内容

直接下载生成的视频文件： 
curl -L "https://models.rivus.cn/v1/videos/$VIDEO_ID/content" \
  -H "Authorization: Bearer $TOKEN" \
  --output "$VIDEO_ID.mp4"

Authorizations

​
Authorization
string
header
required

使用 API Key 作为 Bearer Token

Path Parameters

​
video_id
string
required

视频任务的唯一标识符

Response

查询成功

​
id
string

视频任务的唯一标识符

Example:

"video_691209aab0a08198a4e78870277f7e3d0215e09cec47a737"

​
object
enum<string>

对象类型

Available options:
video
Example:

"video"

​
created_at
integer

创建时间戳（Unix 时间）

Example:

1762789802

​
completed_at
integer

任务完成时间戳（仅在 completed 状态下存在）

Example:

1762789891

​
expires_at
integer

视频过期时间戳（仅在 completed 状态下存在）

Example:

1762793491

​
model
string

使用的模型名称

Example:

"sora-2"

​
status
enum<string>

任务状态

Available options:
queued,
processing,
completed,
failed
Example:

"queued"

​
prompt
string

生成视频的文本描述

Example:

"一个无人机从海滩升空拍摄夕阳"

​
progress
integer

处理进度（0-100）

Required range: 0 <= x <= 100
Example:

0

​
seconds
string

视频时长（字符串格式）

Example:

"10"

​
size
string

视频分辨率

Example:

"1280x720"

​
assets
object[]

生成的视频资源数组，仅在 completed 状态下存在（部分供应商可能不返回此字段，需通过 /content 端点下载）

​
parent_video_id
string

父视频 ID（仅 Remix 任务返回）

Example:

"video_691209aab0a08198a4e78870277f7e3d0215e09cec47a737"

​
error
object

错误信息，仅在 failed 状态下存在