---
title: 常见报错与解决方法
description: 按 400、401、402、403、404、429、500 等状态码排查 API Key、余额、模型、路径和请求频率问题。
---

软件连接失败时，先找到提示中的状态码，再按下面的方法处理。

## 按状态码处理

| 看到的提示 | 常见原因 | 怎么处理 |
| --- | --- | --- |
| **400** | 填写的参数不正确 | 恢复软件的默认参数，确认模型支持图片、工具调用等已开启的功能。 |
| **401** | API Key 不正确或已经失效 | 重新复制完整 API Key，检查前后没有空格，并确认令牌仍处于启用状态。 |
| **402** | 账户余额不足 | 登录控制台，在 **钱包管理** 中充值或兑换额度。 |
| **403** | 当前令牌不能使用该模型 | 换一个模型，或检查令牌分组和模型权限。 |
| **404** | API 地址或模型 ID 填写错误 | 按对应软件教程核对地址，并从模型广场重新复制原始模型 ID。 |
| **429** | 请求太频繁或当前模型繁忙 | 停止重复发送，等待 10 至 30 秒后重试。仍然出现时，降低同时运行的任务数量或换一个模型。 |
| **500 / 502 / 503 / 504** | 服务暂时波动或响应超时 | 等待 10 至 30 秒后重试。持续出现时，换一个模型并查看平台公告。 |

## 不知道状态码时

按下面顺序检查：

1. 确认账户余额充足。
2. 重新复制 API Key，检查前后没有空格。
3. 从[模型广场](https://infistar.cc/pricing)重新复制模型 ID。
4. 按当前软件教程核对 API 地址。有的软件填写 `https://infistar.cc`，有的软件填写 `https://infistar.cc/v1`。
5. 保存设置，完全退出软件后重新打开。

<Warning>
不要把密码、完整 API Key 或完整兑换码发送给任何人。联系客服时，API Key 只保留开头和末尾少量字符。
</Warning>

## 联系客服前准备

仍然无法解决时，请准备以下信息：

- 使用的软件名称和版本
- 出现问题的大致时间
- 模型 ID
- 完整报错截图
- Request ID（页面中有显示时）

前往[联系我们](/contact-feedback/contact-feedback)提交这些信息，可以减少重复沟通。

如果主要问题是 `429 Too Many Requests`，请继续查看[429 与调用频率](/troubleshooting/rate-limits-concurrency)。