常见错误排查

在接入过程中，如果您遇到调用失败的情况，请参考以下常见错误及解决方案。

1. Base URL 配置错误 (404 Not Found)

现象： 请求返回 404，提示路径不存在。
原因： 把完整请求路径误填成了 SDK 的 Base URL。
解决： 确保 SDK 的 Base URL 只配置为 https://api.stillhappy.cn。

2. 身份验证失败 (401 Unauthorized)

现象： 请求返回 401，提示未授权。
原因： 请求头缺少 Authorization 字段，或格式错误。
解决：

Authorization: Bearer YOUR_API_KEY

3. Codex 配置无效

现象： Codex 客户端仍请求 OpenAI 官方地址。
原因： 在 config.toml 中使用了 base_url 而不是 openai_base_url。
解决：

openai_base_url = "https://api.stillhappy.cn/v1"
forced_login_method = "api"

4. Gemini 路径错误

现象： 调用 Gemini 模型时返回路径错误。
原因： 误用 /v1/chat/completions 端点去调用 Gemini。
解决： 改用 /v1beta/models/... 路径，或确保客户端本身支持 Gemini 路由。

5. Antigravity 调用失败

现象： 提示找不到模型或路由错误。
原因： 没有使用 Antigravity 专用 Base URL。
解决： Base URL 应配置为 https://api.stillhappy.cn/antigravity。