常见问题

文档站和主站是什么关系？

这是一个独立静态文档站，和 sub2api 主站不耦合。部署完成后，只需要把主站后台里的“文档链接”填成这个文档站地址即可。

Base URL 到底填哪个？

• 客户端要求 Base URL：填 https://maomaolin.cc。
• 客户端要求 OpenAI API URL：填 https://maomaolin.cc/v1。
• 代码里使用 OpenAI SDK：base_url / baseURL 填 https://maomaolin.cc/v1。
• Anthropic / Claude 类协议：通常填 https://maomaolin.cc。

API Key 前面要不要加 Bearer？

客户端输入框里通常只填 sk-...。写 HTTP 请求时才需要：

Authorization: Bearer sk-你的密钥

为什么我看得到模型，但请求失败？

模型列表代表平台当前支持的公开模型。实际请求还取决于：

• Key 绑定的模型组
• 模型组是否有活跃账号
• 订阅或余额是否足够
• 上游账号是否被限速
• 客户端协议是否匹配

定价是实时的吗？

文档构建时会读取线上实例数据并生成页面。它不是每秒实时刷新，但每次发布文档前会重新同步。

我是管理员，怎么更新模型和定价？

在文档站目录执行：

npm run sync:data
npm run build

然后把 .vitepress/dist 发布到你的静态站托管服务即可。