故障排查指南
快速诊断与解决常见问题
系统化的故障排查流程，帮助您快速定位并解决使用中的各类问题
API调用失败
4xx/5xx 错误码请求返回错误或超时
解决方案：
- 1.检查API密钥是否正确且未过期
- 2.确认余额充足
- 3.验证请求参数格式是否符合文档要求
- 4.查看服务状态页面确认是否有计划维护
- 5.增加请求超时时间并实现重试机制
网络连接问题
ETIMEDOUT, ECONNREFUSED无法访问服务或响应缓慢
解决方案：
- 1.检查本地网络连接是否正常
- 2.尝试切换到备用接入点
- 3.确认防火墙或代理配置允许访问
- 4.使用ping/traceroute诊断网络路径
- 5.如需专线接入，请联系客服
权限与认证错误
401, 403提示无权限或认证失败
解决方案：
- 1.确认请求头中的Authorization格式正确
- 2.检查密钥是否对应正确的项目
- 3.验证IP白名单配置
- 4.确认账号状态正常，无欠费停服
- 5.联系管理员检查团队权限设置
响应速度慢
响应时间 > 预期请求处理时间过长
解决方案：
- 1.优化Prompt以减少Token消耗
- 2.使用较快的模型满足基本需求
- 3.开启流式响应提升用户体验
- 4.合理设置并发数避免排队
- 5.考虑使用缓存减少重复请求
常见问题解答
Q: 如何查看API调用日志？
A: 登录控制台，进入【API管理】-【调用日志】，可以查看最近30天的详细调用记录，包括请求参数、响应结果和错误信息。
Q: 密钥泄露后如何处理？
A: 立即在控制台禁用或删除泄露的密钥，生成新密钥并更新业务配置。同时检查调用日志是否有异常调用，必要时联系客服进行安全排查。
Q: 如何选择合适的模型？
A: 根据任务复杂度选择：简单任务使用快速模型降低成本，复杂推理使用高级模型提升质量。可参考各模型的benchmark数据和使用案例。