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

​
认证

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

​
cURL 示例

curl "$BASE_URL/v1/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

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