获取视频

使用 CometAPI Veo3 获取 API（GET /v1/videos/）通过 video_id 获取状态、查询元数据或下载 Veo3 视频生成结果。

GET /v1/videos/{video_id}

Retrieve a Veo video job

cURL

curl --request GET \
  --url https://api.cometapi.com/v1/videos/{video_id} \
  --header 'Authorization: Bearer <token>'

200

{
  "id": "task_pa9CKKtYlTdxO7IIHOKKhXfjxEu4EQoR",
  "size": "16x9",
  "model": "veo_3_1-4K",
  "object": "video",
  "status": "queued",
  "task_id": "task_pa9CKKtYlTdxO7IIHOKKhXfjxEu4EQoR",
  "progress": 0,
  "created_at": 1773297229
}

使用此端点轮询通过 CometAPI /v1/videos 封装器创建的 Veo 任务。它会返回当前任务状态，以及 CometAPI 为该任务使用的已解析后端 model 信息。

​

轮询循环

1. 先创建任务

   从 Veo3 异步生成 开始，并保存返回的 id。

2. 轮询直到任务结束

   持续调用此端点，直到任务离开 queued 或 in_progress 状态并进入已完成状态。

3. 存储结果

   输出准备就绪后，如果你的应用需要持久副本，请将其转存到你自己的存储中。

​

为什么 model 名称可能会变化

Google 官方的 Veo 工作流仍然是异步轮询循环。CometAPI 保留了这种形式，但响应会被规范化到 /v1/videos 封装器中，并且可能显示已解析的后端 model id，而不是你提交的别名。

授权

Authorization · string · header · 必填

Bearer token authentication. Use your CometAPI key.

路径参数

video_id · string · 必填

Task id returned by the create endpoint.

响应

200 - application/json

Current job state.

id · string · 必填

size · string · 必填

model · string · 必填

object · string · 必填

status · string · 必填

progress · integer · 必填

created_at · integer · 必填

task_id · string