1. 网络连接不稳定或中断

API调用需要稳定的网络连接，任何中断都会导致请求失败。

  1. 1. 检查你的Wi-Fi或移动数据是否正常开启
  2. 2. 尝试访问其他网站确认网络通畅
  3. 3. 如果使用代理/VPN，请暂时关闭测试
  4. 4. 重启路由器或切换网络环境
提示：优先使用稳定的有线网络连接，移动数据可能因信号波动导致API调用失败

2. API密钥无效或权限不足

错误的API密钥或缺少必要权限是最常见的调用异常原因。

  1. 1. 检查API密钥是否完整复制，无多余空格
  2. 2. 确认密钥未过期（通常有有效期限制）
  3. 3. 在纸飞机开发者后台验证密钥权限范围
  4. 4. 如有必要，重新生成API密钥
注意：API密钥属于敏感信息，切勿在公开场合泄露！

3. 请求频率超限或被封禁

API服务都有调用频率限制，过度请求会导致临时封禁。

  1. 1. 检查开发者文档中的API调用配额
  2. 2. 实现请求间隔控制（建议≥500ms）
  3. 3. 如果被封禁，等待1-2小时自动解除
  4. 4. 考虑使用批量接口减少请求次数

常见错误提示及针对性解决方案

错误："Invalid API Key"

API密钥无效或格式错误。

  1. 1. 重新从纸飞机开发者后台获取正确密钥
  2. 2. 检查密钥字符串是否完整复制
  3. 3. 确保密钥未过期

错误："Rate Limit Exceeded"

请求频率超过系统限制。

  1. 1. 立即停止所有API调用
  2. 2. 等待1小时后重试
  3. 3. 后续调用增加间隔时间
  4. 4. 考虑申请更高配额（如有需要）

错误："Internal Server Error"

服务器端出现问题。

  1. 1. 检查纸飞机官方状态页面
  2. 2. 等待30分钟后重试
  3. 3. 如持续出现，联系技术支持