Skip to main content
GET
/
v1
/
videos
/
{video_id}
Error
A valid request URL is required to generate request examples
{ "id": "video_abc123", "object": "video", "status": "in_progress", "model": "veo-3.1-fast-generate-preview", "progress": 45 }
查询已创建的视频生成任务的当前状态、进度和结果。

​
查询视频任务

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

​
响应示例

任务进行中： 
{
  "id": "video_691209aab0a08198a4e78870277f7e3d0215e09cec47a737",
  "object": "video",
  "created_at": 1762789802,
  "status": "in_progress",
  "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：任务已排队，等待处理
  • in_progress / processing：正在生成视频
  • completed / success：生成完成，可下载视频
  • failed：生成失败
不同上游和任务来源可能返回 in_progress/completed 或兼容旧异步任务口径的 processing/success。客户端判断时建议同时兼容这两组状态。

​
响应字段说明

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

​
下载视频内容

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

Authorizations

​
Authorization
string
header
required

API Key

Path Parameters

​
video_id
string
required

视频任务 ID

Response

查询成功

​
id
string

任务 ID

Example:

"video_abc123"

​
object
enum<string>
Available options:
video
Example:

"video"

​
created_at
integer

创建时间戳

Example:

1761234567

​
completed_at
integer

完成时间戳

​
status
enum<string>

任务状态

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

"queued"

​
model
string

模型名称

Example:

"veo-3.1-fast-generate-preview"

​
prompt
string

提示词

​
progress
number

进度（0-100）

Example:

0

​
seconds
integer

视频时长

Example:

6

​
size
string

分辨率

Example:

"1280x720"

​
video_url
string

视频直链（完成后返回）

​
error
object