跳转到主要内容
ToAPIs 为异步任务提交和状态查询使用两个独立令牌桶,不占用同步模型请求额度。 额度按用户 ID 而不是 Token 统计,同一用户的多个 Token 共享额度。提交和查询互不影响。业务失败会计数,被 429 拒绝的请求不计数。批量状态查询一次计一个请求,每次最多 100 个任务 ID。 限流响应头包括 Retry-AfterX-RateLimit-LimitX-RateLimit-RemainingX-RateLimit-ResetX-RateLimit-Category: async_submit|async_query
429
503
提交限流服务不可用时返回 503 rate_limit_unavailable;查询会降级放行并记录监控。推荐以 任务 Webhook 为主、轮询为兜底。轮询间隔至少 5~10 秒,加入随机抖动,并在 429/503 时优先读取 Retry-After,没有该头时再使用指数退避。