跳转到主要内容
“连接失败”可能发生在本地网络、代理、DNS、TLS、接口地址、鉴权或上游模型。按从近到远的顺序检查,避免一次修改多个配置。

排查顺序

1. 检查域名与 HTTPS

API 请求应发往 https://api.apione.ai。控制台 https://apione.ai/zh/app 用于管理账户,不是 API Base URL。
只要能建立 TLS 并返回 HTTP 响应,就说明基础网络已经到达网关;状态码不一定是 200。

2. 用模型列表验证鉴权

模型列表成功后,再测试具体生成接口。这样可以把网络/Key 问题与模型参数问题分开。

3. 比较 cURL 与客户端

如果 cURL 成功而客户端失败,检查客户端实际发送的 Base URL、代理、环境变量和协议。特别注意重复 /v1、自动追加端点、旧配置缓存和系统代理未被客户端继承。

常见现象

代理注意事项

  • 明确代理是系统级、终端级还是仅浏览器扩展。
  • 不要把 API Key 写进代理 URL、公开日志或截图。
  • 企业 HTTPS 检查可能替换证书;应由网络管理员提供合规证书,不要长期关闭证书校验。
  • 分流规则改变后,重新启动实际发请求的客户端。

收集诊断信息

向支持提交:发生时间和时区、域名与端点、客户端版本、网络环境、HTTP 状态、脱敏错误、请求 ID。不要提交完整 Key、Cookie、完整提示词或原始客户文件。 下一步:错误码与排查、地址与鉴权、请求跟踪。