Skip to content

视频任务与轮询

任务提交

统一入口:

text
POST /v1/videos

创建成功后通常会返回下列字段之一:

  • id
  • task_id
  • video_id

任务轮询

轮询接口:

text
GET /v1/videos/{id}

推荐轮询策略

  • 前几次可采用 10s -> 25s -> 25s
  • 之后固定 10s
  • 更高实时性场景可调整到 2s~10s

最大等待时长

  • 普通任务:300s~600s
  • Pro 或高耗时模型:600s~1200s

兼容状态值

text
queued | pending | in_progress | processing | running |
completed | succeeded | done | failed | error | canceled | cancelled

progress 可能缺失,不应作为唯一判断依据。

结果获取

任务完成后,按兼容顺序尝试:

  • video_url
  • data.video_url
  • content.video_url
  • content.url
  • detail.video_url

注意事项

  • 先检查输入图片 URL 是否公网可访问
  • 不要把轮询间隔设得过短
  • 获取到最终 URL 后,建议尽快转存到自有存储

以 VitePress 构建,由 Cloudflare Pages 发布