API 中转站怎么验货？用 AI API Doctor 检测 Base URL、Key、模型和 usage 是否正常

最近很多人开始用各种 API 中转站，主要是为了接 Cursor、Cline、Continue、Claude Code，或者自己写点 AI 应用。

但这里有个很现实的问题：

一个 API 中转站到底能不能用，不能只看老板怎么说，也不能只看价格表。

你真正要看的是：

• Base URL 能不能连通
• API Key 有没有权限
• Model ID 是不是能真实调用
• 返回格式是不是 OpenAI-compatible
• usage 字段有没有正常返回
• tool_calls / function_call 是否兼容
• 稳定性是不是一会儿通一会儿不通

说白了，买 API 前最好先“验货”。

1. 为什么 API 中转站需要验货？

很多新手第一次接 API 中转站，最容易犯的错误就是：

只要拿到 Base URL 和 API Key，就直接丢进 Cursor 或 Cline 里用。

结果一运行就报错：

invalid_api_key model not found no available channel rate limit exceeded 返回 HTML 而不是 JSON

这时候你根本不知道问题出在哪里。

可能是 Key 错了，也可能是模型没权限，也可能是 Base URL 少了/v1，也可能是这个中转站根本没有正常返回 usage 字段。

所以 API 中转站不是“能打开网站就算能用”，而是要真的发一次请求，看返回结果。

2. 最少要检查哪些东西？

我一般建议至少检查 7 个点。

第一，Base URL

常见格式一般是：

https://xxx.com/v1

很多人会填成：

https://xxx.com https://xxx.com/api https://xxx.com/v1/chat/completions

这些都可能导致客户端报错。

Base URL 填错，是 Cursor、Cline、Continue 连接失败里非常常见的原因。

第二，API Key

API Key 不是“有一串 sk- 开头的东西”就一定能用。

它可能：

• 已经过期
• 没有余额
• 没有绑定模型权限
• 被限流
• 被中转站禁用
• 只支持某些模型

所以要真正调用一次接口，不能只看后台显示“已创建”。

第三，Model ID

很多中转站后台写着支持 GPT、Claude、Gemini，但你实际调用时必须填准确的模型名。

比如：

gpt-4o-mini claude-3-5-sonnet gemini-1.5-pro

如果模型名填错，就很容易出现：

model not found

还有一种情况更坑：
API Key 是有效的，但这个 Key 没有你指定模型的权限。

所以“Key 能用”和“目标模型能用”是两回事。

第四，OpenAI-compatible 返回格式

很多工具，比如 Cursor、Cline、Continue，都是按 OpenAI-compatible 接口去适配的。

这意味着返回结构最好是类似这样的：

{ "id": "...", "object": "chat.completion", "choices": [...], "usage": { "prompt_tokens": 10, "completion_tokens": 20, "total_tokens": 30 } }

如果服务端返回的是 HTML、报错页、非标准 JSON，客户端就可能直接挂。

第五，usage 字段

usage 字段很重要，因为它关系到扣费透明度。

正常情况下，你至少希望看到：

prompt_tokens completion_tokens total_tokens

有些服务还会返回 cached_tokens 或者 raw quota 信息。

如果完全没有 usage，你就很难判断一次请求到底消耗了多少。

这不一定代表对方有问题，但至少说明：
扣费透明度不够好。

第六，缓存命中信号

现在有些模型和网关会有缓存机制。

如果缓存命中，理论上成本可能更低，响应也可能更快。

但问题是：

你要能看到证据。

比如 cached_tokens、cache hit、缓存相关字段等。

如果一个平台说“我们有缓存优惠”，但接口返回里完全看不到任何缓存信号，那你就只能靠信任。

第七，稳定性采样

一次请求成功，不代表这个中转站稳定。

我更建议连续测几次，看它是不是：

• 偶尔 502
• 偶尔 timeout
• 偶尔 no available channel
• 同一个模型有时候可用，有时候不可用
• 首 token 特别慢

尤其是接 Cursor / Cline 这种开发工具时，稳定性比便宜几毛钱更重要。

因为你写代码写到一半断掉，体验会非常差。

3. 手动怎么验货？

最简单的方法是 curl。

比如先测模型列表：

curl https://你的域名/v1/models \ -H "Authorization: Bearer 你的API_KEY"

再测一次 chat completions：

curl https://你的域名/v1/chat/completions \ -H "Authorization: Bearer 你的API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "你的模型ID", "messages": [ {"role": "user", "content": "只回复 ok"} ], "max_tokens": 10 }'

然后重点看：

• 有没有返回 choices
• 有没有返回 usage
• model 字段是什么
• 有没有报错信息
• 响应速度是否正常

不过说实话，对普通用户来说，每次都手写 curl 还是麻烦。

4. 我做了一个小工具：AI API Doctor

为了省事，我做了一个小工具，叫AI API Doctor。

它主要用来检测 OpenAI-compatible API 配置是否可用。

你填入：

Base URL API Key Model ID

它会帮你检查：

• Base URL 是否可连接
• API Key 是否有效
• 模型是否能调用
• 返回格式是否兼容
• usage 字段是否存在
• 缓存命中信号是否可见
• 模型身份信号是否一致
• 稳定性采样是否正常

适合在接入 Cursor、Cline、Continue、Claude Code 或 API 中转站之前，先做一次小额验货。

工具地址：https://aiapidoctor.com/

5. 注意：它不是“模型真假鉴定器”

这个要说清楚。

AI API Doctor 不会承诺“百分百证明你调用的一定是真 Claude / 真 GPT”。

因为仅靠一次接口返回，很难做绝对证明。

它做的是更现实的事情：

展示真实请求证据，帮你发现配置风险。

比如：

• Key 是否真的能调用
• 模型 ID 是否可用
• 返回格式是否正常
• usage 是否透明
• 响应自称和目标模型是否一致
• 稳定性有没有明显问题

这比单纯听卖家说“我们很稳”靠谱得多。

API 中转站验货，不要只看价格，也不要只看后台截图。

你至少要检查：

Base URL API Key Model ID OpenAI-compatible 返回格式 usage 字段 缓存命中信号 稳定性采样

如果你只是想快速排查，可以用 AI API Doctor 先测一遍。

最后记住一句话：

API 中转站验货，不是为了证明谁真假，而是为了在你正式接入 Cursor / Cline / Continue / Claude Code 之前，先确认它能不能稳定、透明、正常地跑起来。

开源仓库：https://github.com/JustinXai/ai-api-doctor-site