AI API Doctor 常见问题

AI API Doctor 是一个面向 OpenAI-compatible API 用户的本地优先诊断工具。

它可以帮助你检查 API Key、Base URL、模型权限、分组配置、模型列表接口、对话接口、Token 用量返回和客户端配置是否正常。

它适合以下场景：

• API Key 明明填了，但客户端无法使用
• Base URL 不确定是否正确
• 模型列表能看到，但实际请求失败
• 报错 401 / 403 / 404 / 429
• 中转站提示“无权访问某个分组”
• 想核对本次请求是否返回 usage
• 想导出 Cline / Continue / Cherry Studio 配置

AI API Doctor 不是模型真假鉴定工具，也不是法律意义上的审计工具。

Chrome 扩展版默认将 API Key 保存在你的浏览器本地 chrome.storage.local 中。

AI API Doctor 不会主动把你的 API Key 上传到 Link-AI 或其他第三方服务器。

诊断请求只会发送到你当前选择的 Base URL。例如你选择了某个自定义中转站，诊断请求就会发送到该中转站的 API 地址。

建议你使用专门用于测试的 API Key，不要使用生产环境主 Key。

会。

AI API Doctor 会发送少量真实 API 请求，用来确认你的 Base URL、API Key、模型权限和 chat/completions 是否能正常工作。

基础诊断通常只需要 1 到 3 次请求，消耗较少。具体消耗取决于你的服务商计费方式、模型价格和是否开启更多诊断项。

为了安全，建议你：

• 使用测试专用 Key
• 设置较低额度
• 不要使用生产主 Key
• 诊断后对比服务商后台账单

建议使用测试专用 API Key。

原因是：

• 诊断会发送真实请求
• 可能产生少量 token 消耗
• 测试过程中可能暴露错误信息
• 测试 Key 更容易控制额度和风险

如果你的服务商支持额度限制、分组限制或临时 Key，建议单独创建一个测试 Key。

可以。

AI API Doctor 生成的诊断报告会自动隐藏完整 API Key，只保留脱敏格式，例如：

sk-****abcd

你可以把报告发给站长或客服，用来说明：

• Base URL
• 模型 ID
• 错误码
• 服务商返回信息
• 失败步骤
• usage 情况

但请注意：不要手动把完整 API Key、账户密码或余额截图发给陌生人。

AI API Doctor 可以帮助你核对本次请求的 usage 信息，但不能证明某个服务商故意多扣费。

它能检查：

• 响应里是否返回 usage 字段
• prompt_tokens 是否存在
• completion_tokens 是否存在
• total_tokens 是否异常偏高
• 短请求是否出现明显异常的 token 消耗

但最终余额、扣费和账单由服务商后台控制。AI API Doctor 无法直接读取所有服务商的真实账单系统。

如果你怀疑消耗异常，建议：

• 使用短 prompt 测试
• 记录诊断报告
• 对比服务商后台余额变化
• 联系站长或客服核对

AI API Doctor 的结论应理解为"用量信号核对"，不是法律意义上的财务审计。

部分中转站并不开放 /v1/models，或者模型列表接口不完全兼容 OpenAI 标准格式。

所以 /v1/models 失败不一定代表 API 不可用。

你可以手动输入模型 ID，例如：

• gpt-4o
• deepseek-chat
• claude-3-5-sonnet
• gemini-2.5-pro

然后运行 chat/completions 诊断。

真正更有参考价值的是：指定模型能否完成真实请求。

这类错误通常表示：

• Base URL 是可达的
• API Key 可能也是有效的
• 但当前 Key 没有访问某个模型或模型分组的权限

常见原因包括：

• Key 没有加入正确分组
• Key 所属分组没有包含当前模型
• 模型没有绑定可用渠道
• 渠道不支持当前模型
• 模型别名配置错误

你可以检查中转站后台：

• Key 属于哪个分组
• 分组是否包含当前模型
• 模型是否绑定了可用渠道
• 渠道是否支持该模型
• 模型别名是否正确

这类错误不一定是 Key 错了，也不一定是 Base URL 错了。

401：API Key 错误、为空、过期，或者复制时多了空格。

403：权限不足。可能是 Key 没有模型权限、分组权限不足、IP 白名单限制，或者模型未加入分组。

404：接口地址可能错误。常见情况是 Base URL 少了 /v1、多了 /v1，或者填成了官网地址。

429：请求过快、并发超限、额度耗尽，或者服务商限流。

HTML 响应：服务端返回了网页，而不是 API JSON。可能是填成了网站首页、登录页、Cloudflare 页面，或者服务商不兼容该接口。

No usage：响应中没有返回 usage 字段，因此无法从本次响应核对 Token 消耗。

当前版本不做模型真假鉴定。

AI API Doctor 关注的是：

• 配置是否正确
• Key 是否可用
• 模型权限是否正常
• 分组配置是否正确
• 真实请求是否能完成
• 响应里是否返回 usage
• 客户端配置是否能导出

它不会给出"这个一定是真模型"或"这个一定是假模型"的结论。

模型来源、渠道指纹、签名机制和真实模型鉴定属于更复杂的检测范围，不作为当前版本的判断结论。

不同检测工具的判断依据不同。

部分模型鉴定工具会依赖签名、协议细节、响应指纹、身份回答、多轮测试题或特定行为特征。如果中转站对协议做了兼容处理、签名屏蔽、渠道保护、响应包装或安全策略调整，某些指纹型检测可能出现误判。

这并不代表所有检测工具都不准确，也不代表某个模型一定真实或一定不真实。

AI API Doctor 不根据单一指纹判断模型真假，而是关注实际使用中的几个问题：

• 这个 Base URL 能不能连通
• 这个 API Key 有没有权限
• 这个模型 ID 能不能完成真实请求
• response.usage 是否返回
• Token 用量是否明显异常
• 客户端配置能不能正常工作

如果你需要判断模型来源、官方原版渠道或签名指纹，请结合多个检测方法、实际使用效果和服务商说明综合判断。

AI API Doctor 不做中转站排行榜，也不会因为服务商不同改变诊断逻辑。

Link-AI 是 AI API Doctor 的赞助方和默认内置示例 Provider。你可以使用 Link-AI，也可以删除、切换或添加任何 OpenAI-compatible Base URL。

所有 Provider 使用同一套本地诊断逻辑。

我们不会因为某个服务商是默认内置 Provider，就改变诊断结果。

AI API Doctor 由 Link-AI 发起和赞助。

Link-AI 在工具中作为默认内置 Provider，方便新用户快速理解 Base URL、API Key 和模型诊断流程。

但 AI API Doctor 本身支持任意 OpenAI-compatible API 服务商，诊断逻辑对所有 Provider 一致。

界面中使用：

• Built-in / 默认内置

不使用：

• Recommended / 推荐服务商 / 最佳中转

插件端计划开源，方便用户检查 API Key 的存储方式、请求逻辑和诊断过程。

API Key 默认保存在浏览器本地，不会主动上传到 Link-AI 或其他服务器。

官网、品牌、服务端统计和商业服务可能不完全开源。