服务商验证失败怎么办：五个常见原因逐个排除
AIRI 的服务商验证（Ping API 或同等按钮）失败时，官方通用配置文档给了一条固定的排查顺序。这一页把它展开成可直接执行的动作清单。
官方五步，逐步执行
- 确认账户已开通对应服务且有可用额度：登录服务商控制台，看该模型服务是否开通、余额或免费额度还剩多少。密钥正确但欠费，验证一样失败。
- 重新复制 API Key，检查多余空格或换行：复制时带上前后字符是最高频错误。重贴后仍不行，试着在文本编辑器里肉眼检查首尾。
- 将 Base URL 恢复为服务商默认值，或与其官方文档逐字核对：不确定时先「恢复默认」再试；自定义接口地址要与文档完全一致（含版本路径，不含多余的 completions 后缀）。
- 确认网络、代理和防火墙允许访问该服务商：国际服务商在国内网络环境可能无法直连；本地服务则确认端口通、服务在跑。
- 选择服务商明确支持的模型；不要把展示名称当作模型 ID：模型下拉里看到的是展示名，真正要填的是文档里的模型 ID。
按错误类型的快速分诊
| 现象 | 优先动作 |
|---|---|
| 网络超时 / 连不通 | 第 4 步：代理、防火墙、本地服务状态 |
| 提示鉴权 / 密钥无效 | 第 1、2 步：额度、重贴密钥 |
| 提示模型不存在 | 第 5 步：照文档抄模型 ID |
| 验证过了但没模型可选 | 手动输入模型 ID（部分服务商不提供列表接口） |
验证通过≠配置完成
别忘了最后一环：验证通过后要在「意识」等模块里选中该服务商与模型才会生效，见不回复排查顺序。