请求体字段缺失、格式不符合 API 规范（如 messages 结构错误、temperature 非数字）。

• 检查 API 地址是否为正确的 /v1/chat/completions。
• 确认模型名、messages、temperature 等字段格式正确。

API Key 无效、已过期或未配置。

• 重新复制密钥并粘贴到“密钥”输入框。
• 确认请求头已携带 Bearer Token。

账号权限不足、模型未开通、或被服务端拒绝。

• 检查账号是否有权限使用该模型。
• 确认是否被服务商封禁或限制 IP。

API 地址写错、路径不完整，或服务端未提供该接口。

• 确认地址格式：https://xxx/v1/chat/completions
• 使用“获取模型列表”验证地址是否可用。

请求方式错误（应为 POST 或 GET）。

• 聊天请求必须使用 POST。
• 模型列表请求必须使用 GET。

网络波动、服务端响应过慢。

• 切换更稳定的网络。
• 稍后重试或换模型/服务商。

并发冲突或服务端状态异常。

• 停止频繁点击发送。
• 刷新页面后重试。

上下文消息过多，导致请求体太大。

• 减少上下文记忆条数。
• 清理历史聊天或降低总结长度。

请求头 Content-Type 不是 application/json。

• 确保请求头为 application/json。

参数合法但不可用，例如模型名不存在或长度为 0。

• 确认模型名与服务端列表一致。
• 检查输入是否为空或格式错误。

频率超限或并发过高，也可能是额度不足。

• 等待一段时间再试。
• 检查额度与套餐限制。

请求头或 Cookie 过长。

• 清理浏览器缓存或 Cookie。
• 减少额外自定义请求头。

区域或法律限制导致访问被阻止。

• 更换可用地区的服务商或网络。

模型服务内部故障。

• 稍后重试。
• 更换备用模型或服务商。

上游服务异常或代理配置错误。

• 检查反向代理配置。
• 稍后再试或切换服务。

服务维护、负载过高或临时下线。

• 等待服务恢复。
• 尝试低峰时段请求。

上游模型响应过慢。

• 减少上下文长度。
• 更换更快的模型或节点。

CDN 或防护层出现异常或连接不上源站。

• 稍后重试。
• 检查源站是否正常运行。

HTTPS 证书无效或不受信任。

• 确认服务端证书有效。
• 尝试切换为 HTTP（若服务允许）。

浏览器拒绝访问跨域 API。

• 服务端需开启 CORS。
• 使用代理或后端转发。

地址不可达、DNS 失败或网络被拦截。

• 检查域名是否可访问。
• 确认手机网络权限与代理设置。

模型名写错或该账号未开通。

• 重新获取模型列表并选择。

消息总长度超过模型限制。

• 减少上下文记忆条数。
• 缩短系统提示词或历史内容。

账户余额或调用次数用尽。

• 充值或更换有额度的 Key。

模型返回结构不符合预期，或返回内容为空。

• 检查 API 是否为 OpenAI 兼容格式。
• 确认服务端未返回 HTML/报错页。