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"
}
本页提供标准 OpenAI 风格的查询接口调试面板与示例，仅需携带 Bearer Token。

​
认证

  • Authorization: Bearer <Token>
export BASE_URL="https://models.rivus.cn/v1"
export TOKEN="oh-xxxxxxxxxxxxxxxx"
export VIDEO_ID="video_xxx"  # 创建任务后返回的 id

​
cURL 示例

curl "$BASE_URL/videos/$VIDEO_ID" \
  -H "Authorization: Bearer $TOKEN"
响应字段包含：
  • status：queued/in_progress/completed/failed
  • progress：0–100（若上游未提供，可能为 0）
  • video_url 或 result.video_url：完成后返回的直链（已由网关代理）
若需要在计费端明确时长，可在查询时追加 ?duration=6 指定秒数。

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 状态下存在