跳到正文

API 文档 · 任务

轮询频率建议

退避轮询,终态即停。

没有配置 Webhook 时,用查询接口获取结果。生成通常需要几十秒到数分钟。

  • 首次查询放在提交后 5 秒左右,之后按 1.5 倍逐步放宽,最长间隔 30 秒。
  • 状态到达 succeeded 或 failed 后停止轮询。
  • 查询请求不计费,但计入 RPM 限额;批量场景请使用 GET /v1/videos/generations 列表接口。
  • 配置了 Webhook 时,查询只作为兜底,例如每 5 分钟对未收到回调的任务查询一次。
curl https://cn-api.aitoken.tools/v1/videos/generations/task_xxx \
  -H "Authorization: Bearer $AITOKEN_API_KEY"