文档排错与支持

国内网络接入

网站能打开、API 能连上、模型能回复，是三件不同的事。按这个顺序逐项检查，能很快找到问题出在哪一层。

更新于

先分清两个域名

网站和控制台
https://mallowapi.com
API 接口
https://api.mallowapi.com/v1

网页能打开，不代表 API 能连上；API 能连上，也不代表模型请求一定成功。各地区、运营商和时段的网络情况不同，以你自己的实际测试为准。

一条命令测连通

不需要密钥也能测网络。下面的命令会显示状态码和每一步耗时：

curl -sS -o /dev/null \
  -w "HTTP %{http_code}  DNS %{time_namelookup}s  连接 %{time_connect}s  TLS %{time_appconnect}s  总计 %{time_total}s\n" \
  https://api.mallowapi.com/v1/models
  • 返回 HTTP 401：网络是通的，只是没带密钥。接下来按快速开始带上密钥测试。
  • 卡住或超时：问题在网络层。检查 DNS、代理、公司防火墙；开着代理时，试试关掉或换一个出口。
  • TLS 或证书报错：检查系统时间是否准确，以及是否有软件拦截 HTTPS。

按层排查

  1. 网络层：上面的命令能拿到 HTTP 状态码。
  2. 鉴权层：带上密钥请求 /v1/models 返回模型列表，而不是 401 或 403。
  3. 模型层：发一条短请求，能拿到模型回复。

哪一层失败，就看对应的说明：401、403、404、429 见错误码排查。

密钥放在哪里

放在服务器的环境变量或可信客户端的密钥设置里。不要放进网页前端代码、Git 仓库、截图或群聊。