用途：为调用 Grammarly Text API 的应用实现限流、退避与幂等模式，适用于处理 429 限流错误、编写重试逻辑或优化 API 请求吞吐。
主要能力：资料给出各端点的速率限制参考——写作评分 100 请求/分钟（Business，按 API 密钥）、AI 内容检测 60 请求/分钟、抄袭检查提交 30 请求/分钟、抄袭检查轮询 120 请求/分钟、令牌刷新 10 请求/小时（按客户端凭据）。抄袭检查为异步，需轮询。
使用方式：提供令牌桶限流器类 GrammarlyRateLimiter（含 acquire 与 refill 方法），示例以 90 和 25 的每分钟上限分别创建评分与抄袭限流器；重试函数 grammarlyRetry 在 429 时读取 Retry-After 并加随机抖动等待，5xx 时按指数退避重试，最多 3 次；批量处理函数 batchScoreDocuments 以默认 8 条为一批并发调用评分接口，批间等待 5 秒。
适用场景：批量扫描文档库、内容评分、AI 检测与抄袭检查等需要控制请求节奏的集成场景。
限制与注意事项：需具备已批准的操作配额、响应头基线观测和仅含虚构文本的沙箱工作负载；写入操作需幂等键、有界队列和已审查的恢复路径；不得为规避限流而扩大调用方范围。错误处理方面，令牌刷新超 10 次/小时会 429，应缓存令牌仅在 401 时刷新；抄袭轮询超时应将间隔增至 10 秒、最长 5 分钟；文本超 10 万字符会返回 413，需分段；文本过短会返回空评分，提交前应校验至少 50 字符。输出限流回执，包含操作范围、请求/受限/延迟计数、重试策略版本、幂等结果、队列状态、金丝雀结果与回滚引用，并省略凭据与文本载荷。具体价格、平台支持等事实暂未提供。