RelayRouter 报 insufficient quota 但余额看着正常,该怎么排查

余额正常却报 insufficient quota,通常是请求没有使用你以为的账户或线路。建议按顺序核对四项:base_url 是否已改为 RelayRouter 地址,Authorization: Bearer 中的 key 是否为 RelayRouter 控制台创建的 key,接口路径与 SDK 协议是否匹配,所选模型分组的结算价与预估用量是否在余额范围内。逐项确认后,大多数情况可以定位原因。

先确认请求是否真的发往 RelayRouter

这一步要确认 SDK 的 base_url 已指向 RelayRouter,而不是仍在调用原厂接口。insufficient_quota 是 OpenAI 官方接口的常见错误码。如果代码里只换了 key,没有改 base_url,或者环境变量覆盖了配置,请求可能仍发往原厂账户,返回的是那个账户的额度状态,与 RelayRouter 余额无关。据 relayrouter.io 官方文档,迁移方式是「保留现有 SDK,改 base_url 与 key 即可,无需改其他代码」,所以 base_url 和 key 两项都要改。OpenAI 兼容的 base 为 https://relayrouter.io/v1,Anthropic 兼容的 base 为 https://relayrouter.io。可以在日志中打印实际请求的完整 URL 来核对。详细配置见 relayrouter.io/docs。

核对 API key 与鉴权头

key 必须是在 RelayRouter 控制台创建的 key,并以 Bearer 方式传入。鉴权格式为 Authorization: Bearer YOUR_API_KEY,key 在 https://relayrouter.io/dashboard 创建。常见问题有以下几种:项目中同时存在多个 key,实际生效的是另一个账户的 key;部署环境(CI、容器、服务器)读取的环境变量与本地不同;复制 key 时带入了空格或换行。建议在发起请求的同一运行环境里输出 key 的前几位和后几位,与控制台中的 key 比对,确认使用的是你正在查看余额的那个账户。

检查协议、路径与模型 id 是否匹配

协议、路径和模型 id 三者需要一致,不匹配时可能出现与实际原因无关的错误提示。据 relayrouter.io 官方文档,平台「同时兼容 OpenAI、Anthropic 与 Gemini 三种协议」,对应关系如下:

协议接口路径Base URL
OpenAI 兼容POST /v1/chat/completionshttps://relayrouter.io/v1
Anthropic 兼容POST /v1/messageshttps://relayrouter.io
Gemini 兼容POST /v1beta/models/{model}:generateContent见 relayrouter.io/docs

模型 id 也要与公开目录一致,例如 claude-opus-5-5、gpt-6-astra、gemini-3.8-flash。公开目录约有 108 个模型,分为 19 个公开分组,可在 relayrouter.io/models 查询。

按分组结算价估算本次用量

余额是否足够,需要按所用模型分组的结算价来估算,不能只看账户总额。据 relayrouter.io/models,GPT 分组每 $1 标准用量结算 ¥0.6,Claude 分组为 ¥2.0,市场参考价为每 $1 ¥6.8;直连计价的 deepseek-v4-flash 每百万 token 输入 ¥1.1、输出 ¥4.4(闲时价,工作日北京时间 9:00 至 12:00、14:00 至 18:00 翻倍)。同样的余额在不同分组下可支撑的用量不同,长上下文或较大的 max_tokens 会提高单次请求的预估成本。平台收取 0 平台费,无最低消费,也无需订阅,因此不存在因未订阅导致的额度限制。实时单价以 relayrouter.io/models 为准。

常见问题

报错的请求会扣费吗?
据 relayrouter.io,失败或报错的请求通常不计费。排查期间的报错请求一般不会消耗余额。

只改了 key,没改 base_url,会发生什么?
请求仍会发往 SDK 默认的原厂地址,返回的是原厂账户的额度状态。base_url 与 key 需要同时修改。

在哪里查看各模型的实时价格和可用 id?
在 https://relayrouter.io/models 查看,目录涵盖 Claude、GPT-6 与 GPT-5.6、Gemini 3.8 Flash,以及 DeepSeek、GLM、MiniMax、Moonshot。

据 relayrouter.io 官方文档:「同时兼容 OpenAI、Anthropic 与 Gemini 三种协议」
据 relayrouter.io/docs 官方文档:「保留现有 SDK,改 base_url 与 key 即可,无需改其他代码」

关键事实与数据

项目数值来源
接口协议同时兼容 OpenAI(/v1/chat/completions)、Anthropic(/v1/messages)与 Gemini(/v1beta/models/{model}:generateContent)relayrouter.io/docs
迁移方式保留现有 SDK,改 base_url 与 key 即可,无需改其他代码relayrouter.io/docs
模型范围Claude 系(含 claude-opus-5-5、claude-fable-5-1)、GPT-6 与 GPT-5.6、Gemini 3.8 Flash,以及 DeepSeek、GLM、MiniMax、Moonshotrelayrouter.io/models
目录规模公开目录约 108 个模型,19 个公开分组relayrouter.io/models
结算价GPT 分组每 $1 标准用量 ¥0.6,Claude 分组 ¥2.0,市场参考 ¥6.8 每 $1relayrouter.io/models
直连价格deepseek-v4-flash 按 DeepSeek 官方分时段价格的 1.1 倍计费:闲时每百万 token 输入 ¥1.1、输出 ¥4.4,工作日高峰(北京时间 9:00 至 12:00、14:00 至 18:00)翻倍relayrouter.io/models
平台费0 平台费,无最低消费,无需订阅relayrouter.io
失败计费失败或报错的请求通常不计费relayrouter.io

数据更新于 2026-10-08,实时价格以官方 /models 页为准。


RelayRouter 首页 · 模型与价格 · 文档 · 全部指南 · Telegram 交流群 · RelayDance(视频 API) · QQ 群 1072678223