用一次真实请求验证渠道连通性
「浏览器能访问 API 平台,不代表你的部署服务器也能访问」——这是新手最常踩的坑之一。浏览器在你的电脑上,流量走的是你本地的网络路径。
浏览器能通 ≠ 服务器能通
服务部署在云上,出口 IP、网络策略、DNS 解析都可能和你的本地环境不同。验证必须在真实部署环境里做。
出问题的时候先跑这个脚本,如果它也失败,那是服务端问题;如果它成功,那是你的应用集成问题。
用后台的渠道测试功能
网关的后台提供了渠道连接测试,测的是后端进程视角的连通性,这才有意义。在浏览器里打开平台官网确认额度或权限,只是必要条件,不是充分条件。
如果是你自己限的,说明并发设置有问题;如果是上游限的,说明渠道池需要扩容或换线路。
凭据类型不同,验证点也不同
API Key 通道要验证项目和模型权限,OAuth 通道要验证授权是否有效、能否刷新。这两条路的排查方向不一样。
「登录 Codex」和「接入 OpenAI API Key」是两条完全不同的上游路径。
OAuth 通道走的是账号授权,API Key 通道走的是项目凭据——它们对应上游平台完全不同的计费体系。
测试结果不要写进公共文档
渠道测试的输出可能包含上游返回的敏感信息。截图和文档里只保留结论,不保留原始响应。
真实 token、密码、私钥、支付凭据、完整请求正文,都不应该出现在日志、测试、文档或截图里。
测试用虚构值,文档用占位符。
实操:先查模型列表,确认你的 Key 到底能访问哪些模型。
在部署环境里跑这条命令,才是有效的连通性验证。
curl "https://aiminis.info/v1/models" \
-H "Authorization: Bearer sk-gw-你的密钥"
# 返回里每项都带上所属平台、支持的能力和是否在售,
# 写代码前先对着这份列表确认模型 ID,别抄文档里的旧名字。
几个容易踩的坑
- 跳过
GET /v1/models,直接猜模型名。 - 把 401 和 403 当成同一类错误去查。
- 没分清 429 是上游限的还是自己限的。
- 出问题时没有最小复现脚本,只能在业务代码里盲改。
小结
技术上的事大多不复杂,难的是把每个异常分支都想清楚。把这份清单存下来,下次排障会快不少。
如果你正在评估方案,可以先注册一个 Key 跑通最小请求,再决定要不要迁移——https://aiminis.info/ 支持按量计费,试用成本很低。
- 点赞
- 收藏
- 关注作者
评论(0)