常见问题

Incorrect API key

报错：Incorrect API key provided: sk-...

原因：API Key 填写错误、已过期或已删除。

解决：

1. 登录 WalkAI 面板 检查密钥是否存在
2. 重新复制完整的 Key（sk- 开头）
3. 确认没有多余的空格或换行符
4. 如有疑问，删除旧 Key 创建新的

余额不足

报错：You exceeded your current quota

原因：账户余额为零或不足以完成本次请求。

解决：登录面板充值，参见 充值与额度。

模型不可用

报错：model not found 或 The model does not exist

原因：

• 模型名称拼写错误（注意大小写和版本号）
• 该模型未开放给你的账户

解决：

1. 检查模型名称是否在 支持的模型 列表中
2. 使用 /v1/models 接口查询当前可用模型
3. 联系管理员确认权限

首字响应慢

现象：首字时间超过 5 秒，甚至 10-20 秒。

原因：这是上游推理模型的正常行为，不是 WalkAI 的问题。模型在生成第一个 Token 前需要完成推理过程，推理等级越高耗时越长。

参考：

• gpt-5.5 + xhigh 推理等级：首字 5-20 秒属正常
• claude-opus-4-8：首字 10-20 秒属正常
• gpt-5.4-mini：首字通常 < 1 秒

缓解：降低 reasoning_effort 参数，或换用更轻量的模型。

连接超时

现象：请求无响应或提示连接超时。

排查步骤：

1. 检查网络是否正常：ping walkai.top
2. 如果使用代理，尝试关闭代理或排除 walkai.top 域名
3. 如果仍然不通，联系管理员确认服务状态

Stream 中断

报错：stream disconnected before completion

原因：通常是客户端网络中断或代理软件干扰。

解决：

1. 优先关闭代理软件
2. 如果必须开代理，将 walkai.top 加入直连/排除列表
3. 尝试使用非流式模式（"stream": false）测试是否正常

502 Bad Gateway

现象：返回 502 错误。

原因：上游服务暂时不可用，WalkAI 会自动切换到其他可用线路（failover）。

解决：

• 单次 502 通常会自动恢复，重试即可
• 如果持续 502，联系管理员检查上游账号状态

其他问题

以上没有覆盖到你的问题？请 联系客服 获取帮助。