# 查询视频任务

追踪同一任务，直到完成或失败。

`GET /v1/videos/{video_id}`

<a id="authentication"></a>

## 鉴权

使用 Authorization: Bearer YOUR_API_KEY。所选模型须在该密钥分组内开放；JSON 请求使用 Content-Type: application/json。

<a id="parameters"></a>

## 参数



| 字段 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| video_id | path string | 必填 | 提交接口返回的 id。 |

<a id="request"></a>

## 请求示例



```
VIDEO_ID='YOUR_VIDEO_ID'

curl --fail-with-body --silent --show-error \
  "https://api.ohgrok.com/v1/videos/$VIDEO_ID" \
  -H "Authorization: Bearer $OHGROK_API_KEY"
```

<a id="response"></a>

## 响应结构

公开状态为 queued、in_progress、completed、failed 或 unknown。queued/in_progress 时隔一段时间查询，completed/failed 后停止；unknown 应先排查，不直接重新提交。progress（如有）不是完成时间承诺。

```
{"id":"YOUR_VIDEO_ID","status":"completed"}
```

<a id="errors"></a>

## 错误处理

结合 HTTP 状态与返回的错误信息排查。鉴权或模型权限错误先检查密钥与分组；额度或限流错误检查余额及上游限制；超时时保留已有任务 ID。

- [排查一次请求](/zh/docs/errors/)