Skip to main content
GET
/
v1
/
videos
/
{video_id}
查询视频任务
curl --request GET \
  --url https://models.kapon.cloud/v1/videos/{video_id} \
  --header 'Authorization: Bearer <token>'
{
"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": "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.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