用途:帮助开发者理解并处理 OpenRouter 的速率限制,适用于遇到 429 错误、构建高吞吐系统或实现重试逻辑的场景。
主要能力:说明限流按 key 而非账号计算,免费 key 限额较低、付费 key 随余额提高;免费模型另有每日上限(免费用户 50 次/天,余额 10 美元以上 1000 次/天)。提供查询当前限额、读取限流响应头、SDK 自动重试、客户端令牌桶限流和批量并发处理等方法。
使用方式:用 curl 查询限额:curl -s https://openrouter.ai/api/v1/auth/key -H "Authorization: Bearer $OPENROUTER_API_KEY" | jq '.data.rate_limit'。在 OpenAI SDK 中设置 base_url="https://openrouter.ai/api/v1"、max_retries=5、timeout=60.0,SDK 会自动捕获 429 并按 Retry-After 与指数退避加抖动重试。客户端可用 TokenBucket 限流器,将速率设在服务端限额之下(如 200/10s 上限下设为 150/10s)。批量任务用信号量控制并发并错开请求起始时间。
限制:资料未提供具体付费层级数值、价格或企业方案细节;免费模型每日上限与按 key 限流相互独立;需自行监控 x-ratelimit-remaining 等响应头以提前发现接近限额。