# 提交并追踪视频任务

创建任务，查询状态，下载完成的视频片段。

<a id="overview"></a>

## 请求前

视频生成采用异步流程：提交一次，保存返回的任务 ID，之后查询同一任务，直到进入最终状态。本示例使用 seedance-2.0-fast。

视频生成通过 API 使用。注册已开放；请检查钱包余额与当前充值选项，再选择匹配的密钥分组，并确认上游容量。

<a id="prepare-video"></a>

## 1. 检查分组与规格

本示例请在「快速生成｜Seedance Fast（seedance 2.0-fast（限时折扣））」分组创建本站 API 密钥，提交前在模型页核对当前分组费率与支持规格。

- 本示例使用文本提示词，请求一段 5 秒、720p 的视频。
- 当前视频路由支持 JSON 及引用 URL 的 multipart 请求，尚未实现本地二进制上传、草稿引用和 frames 参数。
- 时长与分辨率会影响视频 tokens 的估算。如上游返回实际用量，最终按该用量计费，并非每段视频采用固定价格。

<a id="submit-video"></a>

## 2. 提交一次并保存 ID

发送以下请求并保存 JSON 响应。从成功响应中读取 id 字段，后续所有查询均使用同一个 ID。

提交出现结果不明的超时后，请先查看任务记录，再决定是否创建新任务。新的 POST 请求可能启动另一笔计费任务。

```
export OHGROK_API_KEY='YOUR_API_KEY'

curl --fail-with-body --silent --show-error \
  'https://api.ohgrok.com/v1/videos' \
  -H "Authorization: Bearer $OHGROK_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "seedance-2.0-fast",
    "prompt": "Clouds moving slowly over a quiet mountain lake",
    "seconds": 5,
    "resolution": "720p"
  }' \
  -o video-response.json
```

<a id="check-status"></a>

## 3. 查询同一个任务

将 YOUR_VIDEO_ID 替换为上一步返回的 id。公开状态可能为 queued、in_progress、completed、failed 或 unknown。仍在排队或执行时，等待后再查询同一任务。

状态变为 completed 或 failed 后停止轮询。unknown 状态需要进一步排查，请勿直接重复提交。进度仅表示任务状态，不代表保证的完成时间。

```
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="download-video"></a>

## 4. 下载完成的视频

同一任务返回 completed 后，使用同一网站 API 密钥获取内容。失败任务应结合错误信息和控制台记录排查，不要继续请求内容下载端点。

首页示例影片为 Big Buck Bunny 的剪辑片段，非 ohgrok 生成的视频，也不是本指南的实际生成结果。

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

