Markdown ↗

OHGROK / 接入指南

查询视频任务

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

GET/v1/videos/{video_id}获取 Markdown ↗
本页内容

鉴权

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

参数

字段类型必填说明
video_idpath string必填提交接口返回的 id。

请求示例

cURL
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"

响应结构

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

结构示例，非真实调用回执
{"id":"YOUR_VIDEO_ID","status":"completed"}

错误处理

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

排查一次请求