大模型 API 调用问题自查指南：这样反馈，快速解决你的问题

作为 API易的站长，每天都会收到不少用户反馈调用失败或没有跑通的问题。为了更快地定位和解决问题，这里我整理了一个完整的自查和反馈指南，可以帮助你快速解决问题。

欢迎免费试用 API易，3 分钟跑通 API 调用 www.apiyi.com
支持 OpenAI、Claude、Gemini 等全系列模型

第一步：检查服务状态

1. 检查 API易服务状态

访问 API易状态监控页面
查看所有指标是否显示绿色
如果有红色或黄色警告，说明服务可能存在问题

2. 检查源服务状态

OpenAI 服务状态：status.openai.com
Anthropic (Claude) 状态：status.anthropic.com
Google (Gemini) 状态：status.cloud.google.com

如果以上监控都显示正常，那么问题很可能出在代码或配置层面。

3. 用 Curl 示例代码测试接口连通性

点击API易后台的-令牌栏目，进入可以查看到各种代码格式的示例代码，

或直接用下方的 Curl + 自己的 Key，打开系统自带的终端/iTerm请求下 ↓

代码里更改为自己想用的模型

curl https://vip.apiyi.com/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer 修改为自己的Key$" \
-d '{
"model": "gpt-3.5-turbo",
"stream": false,
"messages": [
{"role": "system", "content": "You are a helpful assistant."},
{"role": "user", "content": "Hello!"} 
]
}'

第二步：新手必读

如果你是第一次使用 API易，请务必：

阅读官网教程
- 访问 API易首页
- 查看”快速开始”部分
- 阅读常见问题解答
参考示例代码
- 确保 API 地址正确：vip.apiyi.com
- 检查 API Key 格式：以 sk- 开头
- 验证模型名称是否正确
查看调用日志
- 登录后台查看调用记录
- 检查是否有明显的错误信息
- 确认余额是否充足

第三步：AI 辅助排查

遇到问题时，建议：

询问 AI 助手
- 将完整代码发给 AI
- 附上具体的错误信息
- 让 AI 帮你分析问题 —— 这里能够解决 90%的问题，我们站内的对话即可使用
  - https://help.apiyi.com/apiyi-user-guide.html
常见错误自查
- 401 错误：检查 API Key
- 429 错误：检查并发限制
- 503 错误：检查网络连接

那怎么反馈，让我们更高效？

如果自查后仍无法解决，请务必带图和报错信息发给我，我替你判断

可补充更多：

### 问题描述
[简要描述你遇到的问题]

### 使用环境
- 编程语言：Python/Node.js/其他
- 使用的模型：gpt-4o/claude-3/等
- API易 Key：sk-xxx（隐藏中间部分）

### 代码示例
```python
# 你的代码片段

错误信息

完整的错误日志

已尝试的解决方案

已经尝试了…
检查了…

常见问题速查

连接问题

检查网络连接
验证 API 地址
确认防火墙设置

认证问题

检查 Key 是否正确
确认余额是否充足
验证请求格式

模型问题

确认模型名称正确
检查参数设置
验证输入格式

最后的建议

保持耐心

按步骤排查
仔细阅读错误信息
详细记录问题细节

善用工具

使用 API 调试工具
参考官方文档
查看示例代码

寻求帮助

提供完整信息
清晰描述问题
说明尝试过的方案