---
title: 视频查询与下载
description: 通过创建任务的同一把 API Key 查询视频状态，并在完成后保存视频。
api: "GET /v1/videos/{id}"
---

<RequestExample>
```bash 查询状态
curl https://sub.vcnovb.cn/v1/videos/TASK_ID \
  -H "Authorization: Bearer $VC_API_KEY"
```
```bash 下载内容
curl --fail https://sub.vcnovb.cn/v1/videos/TASK_ID/content \
  -H "Authorization: Bearer $VC_API_KEY" \
  --output video.mp4
```
</RequestExample>

<ParamField path="id" type="string" required>创建视频请求返回的真实任务 ID，替换示例中的 TASK_ID。</ParamField>

## 查询流程

1. 保存创建响应中的 ID。不同模型可能放在 `id`、`request_id` 或嵌套任务字段中，按实际响应读取。
2. 使用同一 Key 和原分组查询，间隔数秒，长任务适当退避。
3. 排队或处理中继续等待；确认完成后读取结果地址或调用内容接口。
4. 明确失败时记录错误，核对任务日志及退款状态。

各模型的返回字段和状态值见 [H3](/models/h3/query)、[WAN 3.0](/models/wan3/query)、[Grok](/models/grok/query) 查询文档。未返回进度百分比时，按任务状态判断。

## 内容接口

支持内容下载的任务可调用 `GET /v1/videos/{id}/content`，请求头需携带创建任务的 API Key。

如果任务返回可直接访问的结果链接，请及时下载。只向可信的 VC API 地址发送你的 Key，不要把鉴权头转发到任意结果 URL。

## 失败和重试

任务失败、取消或过期后，在[任务记录](/guides/usage)查看错误和退款状态。查询超时或暂时不可用时，继续查询原任务。

不要删除创建任务的 Key，也不要在任务未结束时改绑分组。需要协助时提交任务 ID、创建时间、模型、分组和错误摘要。