1. 检查分组与规格

本示例请在已启用的「渠道1 / seedance 2.0-fast（限时折扣）」分组中创建网站 API 密钥。在模型页核对当前价格与支持规格；分组名称不代表永久折扣承诺。

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

2. 提交一次并保存 ID

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

终端 · 提交任务
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

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

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"

4. 下载完成的视频

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

终端 · 下载结果
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

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

下一步，先小步试试。

扩大工作流之前，先确认结果与当前用量。

浏览模型