最近很多人开始用各种 API 中转站主要是为了接 Cursor、Cline、Continue、Claude Code或者自己写点 AI 应用。但这里有个很现实的问题一个 API 中转站到底能不能用不能只看老板怎么说也不能只看价格表。你真正要看的是Base URL 能不能连通API Key 有没有权限Model ID 是不是能真实调用返回格式是不是 OpenAI-compatibleusage 字段有没有正常返回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 KeyAPI 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 completionscurl 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有没有返回 usagemodel 字段是什么有没有报错信息响应速度是否正常不过说实话对普通用户来说每次都手写 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
