连通和鉴权
先确认 base URL 可达、证书正常、Key 鉴权通过。连通性问题通常应该在写业务代码前就被排除。
AI API AVAILABILITY
AI API 可用性测试
AI API 可用性测试用于回答一个接入前问题：这个接口现在能不能稳定工作？它覆盖网络连通、Key 鉴权、模型权限、错误返回和失败率，而不只是看一次请求是否成功。
模型权限
Key 可用不代表所有模型都可用。测试需要覆盖实际要调用的模型、上下文长度和输出方式。
异常场景
可用性还包括错误是否可解释：余额不足、限流、模型不存在、请求格式错误和超时都应返回清晰信息。
上线前初筛步骤
- 测试 base URL、鉴权、模型列表和目标模型。
- 分别发送短请求、长请求和流式请求。
- 记录 HTTP 状态、错误消息、首包时间和失败率。
- 用测试环境复测后，再决定是否接入生产。
常见问题
可用性测试失败一定不能用吗？
不一定。可能是 Key、模型名、额度或网络配置错误。需要结合错误信息复测。
为什么要测试错误返回？
线上故障不可避免，清晰错误能帮助快速定位问题；模糊错误会放大排障成本。
应该多久复测一次？
对生产依赖的通道，建议在供应商变更、充值前、业务高峰前和发现异常时复测。