Markdown ↗

OHGROK / 接入指南

提交视频任务

提交一次，并保存返回的任务 ID。

POST/v1/videos获取 Markdown ↗
本页内容

鉴权

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

参数

字段类型必填说明
modelstring必填示例：seedance-2.0-fast。
promptstring必填本最小示例使用文本提示词。
secondsnumber可选示例请求 5 秒；支持范围取决于模型。
resolutionstring可选示例使用 720p，具体支持范围以模型为准。

请求示例

cURL
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

响应结构

保存返回的 id，后续查询该 ID，不要重复创建任务。当前配置支持 JSON 与 URL 引用的 multipart 请求；本地二进制上传、草稿引用和 frames 暂未实现。本页提供最小 JSON 流程。

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

错误处理

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

排查一次请求