速率限制

ARouter 实施速率限制以确保公平访问并保护服务可用性。创建更多账户或 API Key 不会增加速率限制 — 容量按账户全局管理。

查看当前限制

要查看 API Key 的速率限制或剩余积分，请向 /v1/key 发起 GET 请求：

Python
Node.js
cURL

import requests

response = requests.get(
    "https://api.arouter.ai/v1/key",
    headers={"Authorization": f"Bearer {AROUTER_API_KEY}"}
)
print(response.json())

const response = await fetch("https://api.arouter.ai/v1/key", {
  headers: { Authorization: `Bearer ${process.env.AROUTER_API_KEY}` },
});
const keyInfo = await response.json();
console.log(keyInfo);

curl https://api.arouter.ai/v1/key \
  -H "Authorization: Bearer $AROUTER_API_KEY"

有效的 API Key 将返回：

{
  "data": {
    "label": "my-key",
    "limit": 100.0,
    "limit_reset": "monthly",
    "limit_remaining": 72.45,
    "usage": 27.55,
    "usage_daily": 2.10,
    "usage_weekly": 8.40,
    "usage_monthly": 27.55,
    "is_free_tier": false
  }
}

字段	说明
`limit`	此密钥的积分限额（null = 无限制）
`limit_reset`	限额重置时间（`daily`、`weekly`、`monthly` 或 null）
`limit_remaining`	密钥被封锁前剩余的积分
`usage`	历史累计消耗的积分
`usage_daily` / `_weekly` / `_monthly`	当前 UTC 周期的使用量
`is_free_tier`	账户是否曾购买积分

免费套餐限制

ID 以 :free 结尾的模型无需购买积分即可使用，但受以下限制：

条件	RPM	RPD
未购买付费积分	20 次/分钟	50 次/天
已购买至少 $5 的积分	20 次/分钟	1,000 次/天

免费套餐限制仅适用于免费模型变体（后缀 :free）。付费模型需要积分余额。

DDoS 防护

Cloudflare 的 DDoS 防护会自动拦截明显超出合理使用模式的请求。这些拦截是临时的，待流量恢复正常后自动解除。

余额为负

如果账户积分余额为负，可能会看到 402 Payment Required 错误——包括在免费模型上。充值使余额恢复到零以上即可恢复访问。

单密钥消费限额

您可以在单个 API Key 上配置消费限额以控制成本：

限额：密钥可消耗的最大积分
重置间隔：daily、weekly、monthly 或 never

通过密钥管理 API 在创建或更新密钥时设置限额。

模型特定限制

某些高需求模型可能有独立于账户总配额的额外单模型速率限制。如果在特定模型上遇到 429 Too Many Requests 错误，请考虑：

使用 :floor 或 :nitro 变体以访问不同的服务商端点
指定有序的候选模型列表以将负载分散到多个模型
在客户端实现指数退避和重试逻辑

请参阅错误处理了解重试最佳实践。

快速开始

核心概念

路由

功能特性

使用指南

隐私

管理

最佳实践

框架与集成

供应商接入

帮助

查看当前限制

免费套餐限制

DDoS 防护

余额为负

单密钥消费限额

模型特定限制

​查看当前限制

​免费套餐限制

​DDoS 防护

​余额为负

​单密钥消费限额

​模型特定限制

查看当前限制

免费套餐限制

DDoS 防护

余额为负

单密钥消费限额

模型特定限制