我们第一期内测陆陆续续已经进入尾声,即将开启第二期内测。在这个过程中,也遇到一些很不错的反馈,后期我们会提出所有的建议的这些朋友在原本计划的必须顶起!RealPLC内测正式开启,每人每月赠送10000000Tokens!基础上,再额外赠送1000000tokens不等,预计发放时间在6月1日。
那么,在对话过程中,有好几位测试的朋友反馈了:

当然,可能跟这个还不能完全相同。所以,我们这期归纳总结下,后期在内测结束后统一会写到docs文件中,可以在我们网站直接查阅。
01
关键原因
我们目前AutoFree模型是集合几家提供的free额度及免费套餐,本身来说,在同一时间使用量大以后,响应变慢,或者说出错的可能性也会提升,所以,会出现一些Error。
像我们对话框看的这类错误,基本是请求HTTP的外部资源报错,除了上图的错误,还有几位朋友反馈了:

还有410错误:

我们这里也做个汇总和优化的方案。
02
Error汇总
我们总结如下表所示,可及时查看:
状态码 | 名称 | 含义 | 在 AI API 中的常见原因 | 解决办法 |
|---|---|---|---|---|
400 | Bad Request | 请求格式错误 | prompt 为空、参数不合法、messages 结构错误、模型不支持 stream 模式 | 检查请求参数格式,确认模型名正确 |
401 | Unauthorized | 未授权/认证失败 | API Key 缺失、过期、无效、格式错误 | 刷新 API Key,检查是否已过期 |
402 | Payment Required | 需要付费 | 账户欠费、余额不足 | 充值账户 |
403 | Forbidden | 禁止访问 | 无权访问该模型(区域限制、组织限制)、API Key 无此模型权限 | 检查 API Key 权限范围,确认区域可用性 |
404 | Not Found | 资源未找到 | 模型名称拼写错误、模型 ID 不存在、endpoint 路径错误 | 核对模型名称,查阅提供商文档 |
405 | Method Not Allowed | 方法不允许 | 对 endpoint 使用了不正确的 HTTP 方法 | 通常是 SDK 内部问题,检查 baseURL 配置 |
407 | Proxy Authentication Required | 需要代理认证 | 企业网络代理需要认证 | 配置代理凭据 |
408 | Request Timeout | 请求超时 | 服务端在指定时间内未收到完整请求 | 检查网络连接,降低请求大小 |
409 | Conflict | 冲突 | 并发请求冲突、资源状态冲突 | 重试请求 |
410 | Gone | 资源已永久移除 | 模型已被永久下线/废弃、API 版本已退役 | 切换到替代模型或新版本 |
413 | Payload Too Large | 请求体过大 | prompt 长度超出模型上下文窗口限制 | 缩短 prompt 或减少历史消息数量 |
415 | Unsupported Media Type | 不支持的媒体类型 | Content-Type 头设置错误 | 通常是 SDK 内部问题 |
422 | Unprocessable Entity | 无法处理的实体 | 请求格式正确但语义有误,参数值不合法 | 检查参数值范围 |
429 | Too Many Requests | 请求过多 | 速率限制 / Rate Limit、并发超限、RPM/TPM 配额耗尽 | 降低并发数、等待冷却、升级 API 套餐 |
当然可能也有服务器类的错误:
状态码 | 名称 | 含义 | 在 AI API 中的常见原因 | 解决办法 |
|---|---|---|---|---|
500 | Internal Server Error | 服务器内部错误 | 提供商服务端异常、模型推理出错 | 重试,RealPLC 自动切换下一个模型 |
502 | Bad Gateway | 网关错误 | 提供商上游服务异常、代理层故障 | 重试,等待恢复 |
503 | Service Unavailable | 服务不可用 | 模型正在维护、过载、临时下线 | 等待后重试,检查提供商状态页 |
504 | Gateway Timeout | 网关超时 | 模型推理耗时过长、上游响应超时 | 降低 prompt 复杂度,切换到更快模型 |
507 | Insufficient Storage | 存储不足 | 提供商资源耗尽 | 等待恢复,切换到其他提供商 |
529 | Overloaded | 服务过载 | 模型请求队列过长 | 等待后重试 |
如果还有其他没有列出来的故障代码,请留意,后期补充哦!
03
其他模型
目前一起把国内外主要的模型都包括在内了,后期只会保留AutoFree和DeepSeek国内几家,其他的模型统一放到自定义模型里。
如果选用除了AutoFree外的模型,其他的均需要自己在设置界面配置API key,否则会出现上图的Error错误。
配置第三方模型具体参考:仅需三步!在RealPLC里调用DeepSeek V4,轻松搞定PLC自动编程!