USER MANUAL
KeyGo 用户使用手册
本手册面向普通用户，按实际使用顺序说明 KeyGo 的账号、充值、API Key、号池、模型、软件配置、用量账单、安全和故障排查。
统一 Base URL
https://keygo.vip
新软件和新项目都优先填写这个地址。只有老软件强制要求 /v1 时，才使用兼容地址 https://keygo.vip/v1。
适用场景
KeyGo 用于把控制台账号余额、模型资源和不同号池统一转换成可调用的 API。用户可以在控制台充值、创建密钥，然后在 Claude Code、OpenAI SDK、Chatbox、Cherry Studio、NextChat、LobeChat、Open WebUI 等软件中使用。
| 用户类型 | 主要用途 | 推荐阅读 |
|---|---|---|
| 刚开始使用的用户 | 注册、充值、创建 API Key、跑通第一次调用。 | 阅读本页 1 到 7 节。 |
| 客户端用户 | 在 Claude Code 或聊天软件里配置 KeyGo。 | 重点阅读软件配置、模型选择和排障部分。 |
| 开发者用户 | 在后端代码、脚本或自动化任务里调用 API。 | 重点阅读 API Key、安全、请求测试和生产建议。 |
| 团队或长期用户 | 按项目拆分密钥、核对账单、控制风险。 | 重点阅读用量账单、密钥管理和最佳实践。 |
1. 注册与登录
- 打开控制台访问 https://keygo.vip/，进入 KeyGo 控制台。
- 注册账号使用常用邮箱注册，按页面提示完成邮箱验证或其他必要校验。
- 登录控制台登录后确认页面能正常显示余额、菜单、密钥或模型相关入口。
- 完善账号信息如系统要求绑定邮箱、设置密码、同意服务条款或补充安全信息，请先完成。
账号建议：不要多人共用同一个登录密码。团队使用时应让每个人使用自己的账号，密钥按软件或项目单独创建。
2. 控制台主要功能
控制台是管理资源的入口。不同账号看到的菜单可能略有差异，最终以登录后页面展示为准。
| 功能 | 作用 | 使用重点 |
|---|---|---|
| 首页或概览 | 查看余额、账号状态、公告和快捷入口。 | 首次登录后先确认账号状态正常。 |
| 充值 | 给账号余额充值，用于后续模型调用扣费。 | 充值后刷新页面确认余额到账。 |
| API Key / 密钥 | 创建、查看、停用或删除调用密钥。 | 一个软件或项目建议使用一个独立密钥。 |
| 模型或价格 | 查看当前账号可用模型、分组、倍率和说明。 | 复制精确模型 ID，避免写错名称。 |
| 用量或账单 | 查看每次调用的消耗、时间、模型和余额变化。 | 排查扣费、失败和异常消耗时优先查看。 |
| 个人中心 | 管理账号资料、密码、安全设置等。 | 定期检查安全设置和登录信息。 |
3. 充值与余额
- 进入控制台的充值页面。
- 选择合适金额，确认支付方式和订单金额。
- 完成支付后回到控制台，刷新页面查看余额是否到账。
- 如果余额未及时更新，先等待片刻并刷新页面，再根据订单号联系支持。
余额用于支付模型调用消耗。余额不足时，请求可能失败，客户端可能显示额度不足、余额不足、429、403 或类似错误。
| 情况 | 处理方式 |
|---|---|
| 刚充值但余额未变化 | 刷新控制台，确认是否登录了正确账号；仍未到账时保留订单号。 |
| 余额足够但请求失败 | 检查 API Key 是否属于当前账号，模型和分组是否有权限。 |
| 余额消耗异常 | 查看用量明细，按时间、密钥、模型和软件定位来源。 |
4. 创建和管理 API Key
API Key 是软件调用 KeyGo 的凭证。登录密码只用于进入控制台，不能代替 API Key。
- 进入密钥页面打开 API Key、令牌或密钥管理入口。
- 创建新密钥给密钥起一个容易识别的名称，例如
claude-code-office、chatbox-phone、backend-prod。 - 选择分组或号池如果创建时需要选择分组，请根据用途选择普通组、稳定组或已授权的专属组。
- 复制并保存密钥完整密钥通常只显示一次，请保存到密码管理器或服务端环境变量中。
- 按用途隔离不同软件、不同项目、测试环境和生产环境建议使用不同密钥。
密钥泄露处理：一旦怀疑 API Key 被泄露，立即在控制台停用或删除旧密钥，然后创建新密钥并更新软件配置。
5. 理解模型、号池和分组
KeyGo 通过分组控制可见模型、可调用资源、倍率和使用权限。你创建 API Key 时绑定的分组，会影响这把密钥实际能调用什么模型。
| 类型 | 可见规则 | 适合场景 |
|---|---|---|
| 普通组 | 默认对普通用户可见。 | 日常对话、轻量开发、功能测试。 |
| 稳定组 | 通常倍率更高，但稳定性或资源质量更好。 | 重要任务、长上下文任务、生产任务。 |
| 专属组 | 必须显式授权才可见，普通用户和管理员都遵循授权规则。 | 内部号池、低倍率资源、专用客户或灰度测试。 |
如果你看不到某个模型或号池，通常是因为账号未被授权、API Key 绑定了其他分组、模型暂时下线、余额不足或账号状态异常。
6. 选择模型
- 进入控制台模型或价格页面，查看当前账号可用模型。
- 复制完整模型 ID，不要凭记忆手写简称。
- 确认模型是否支持你的任务，例如文本对话、代码、图片理解、图像生成或长上下文。
- 先用低成本模型或小请求测试，再切换到正式模型。
| 任务 | 选择建议 |
|---|---|
| 日常聊天和简单写作 | 优先选择成本较低、响应快的文本模型。 |
| 代码生成和项目分析 | 选择代码能力更强、上下文更长的模型，并关注稳定性。 |
| 图片理解或文档识别 | 确认模型支持视觉输入，并按客户端要求上传图片或文件。 |
| 生产任务 | 优先使用稳定组或经过测试的号池，并配置重试和超时。 |
7. 配置软件客户端
大多数软件只需要填写四个信息：服务商类型、Base URL、API Key、模型名称。
| 字段 | 填写内容 | 说明 |
|---|---|---|
| 服务商 / Provider | OpenAI Compatible / 自定义 OpenAI / OpenAI 兼容 | 不要选择只能登录官方账号的模式。 |
| Base URL | https://keygo.vip | 新配置统一填写根地址。 |
| API Key | YOUR_KEYGO_API_KEY | 使用控制台创建的密钥。 |
| Model | YOUR_MODEL_NAME | 填写控制台可用的精确模型 ID。 |
Claude Code
Claude Code 使用终端环境变量配置：
export ANTHROPIC_BASE_URL=https://keygo.vip
export ANTHROPIC_AUTH_TOKEN=YOUR_KEYGO_API_KEY设置后进入项目目录运行：
claudeChatbox、Cherry Studio、NextChat、LobeChat、Open WebUI
- 进入软件的设置、模型、API 或 Provider 页面。
- 新增自定义 OpenAI 兼容服务。
- Base URL 填
https://keygo.vip。 - API Key 填控制台密钥。
- 模型处填写控制台可用模型 ID。
- 保存后发送一句简单测试消息。
服务端代码
服务端项目推荐把密钥放在环境变量中，不要写死在代码里。
export KEYGO_API_KEY=YOUR_KEYGO_API_KEYcurl https://keygo.vip/chat/completions \
-H "Authorization: Bearer YOUR_KEYGO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "YOUR_MODEL_NAME",
"messages": [
{"role": "user", "content": "测试连接"}
]
}'8. 正确处理 /v1
KeyGo 推荐新配置统一使用 https://keygo.vip。不要因为 OpenAI 兼容接口就主动追加 /v1。
| 软件行为 | 正确填写 | 原因 |
|---|---|---|
| 允许填写任意 Base URL | https://keygo.vip | 推荐配置，适合新软件。 |
软件会自动追加 /v1 | https://keygo.vip | 避免最终变成 /v1/v1。 |
软件强制要求以 /v1 结尾 | https://keygo.vip/v1 | 作为兼容配置使用。 |
9. 测试是否配置成功
- 软件能正常返回模型回复。
- 控制台用量记录能看到对应请求。
- 请求使用的模型、密钥、分组和预期一致。
- 余额有正常变化，没有出现异常高频请求。
- 没有持续出现鉴权失败、模型不存在、余额不足或连接失败。
首次测试建议使用一句短问题，确认链路正确后再执行长文本、代码分析、批量任务或生产调用。
10. 查看用量和账单
用量明细是核对扣费和排查问题的主要依据。出现异常时，优先按时间、密钥、模型、分组和客户端定位。
| 需要核对 | 说明 |
|---|---|
| 请求时间 | 确认是哪一次软件操作产生了消耗。 |
| API Key | 判断消耗来自哪个软件、项目或设备。 |
| 模型名称 | 确认是否误用了高成本模型或错误模型。 |
| 分组和倍率 | 确认是否使用了预期号池。 |
| 输入和输出 | 长上下文、大文件、图片和长回答都会增加消耗。 |
| 错误记录 | 定位 401、403、429、5xx、超时和模型不可用问题。 |
11. 常见错误处理
| 现象 | 常见原因 | 处理方式 |
|---|---|---|
| 401 Unauthorized | API Key 错误、复制不完整、密钥已停用。 | 重新复制密钥，检查请求头是否为 Authorization: Bearer ...。 |
| 403 Forbidden | 模型或专属组无权限。 | 检查 API Key 绑定分组，确认账号是否获得授权。 |
| 429 Too Many Requests | 并发过高、余额或额度不足、上游限流。 | 降低频率，等待后重试，生产环境配置有限次数退避。 |
| 模型不存在 | 模型 ID 写错，或当前分组不可见。 | 从控制台复制精确模型 ID，并确认分组权限。 |
| 连接失败 | Base URL 错误、网络代理异常、软件自动拼错路径。 | 确认 Base URL 是 https://keygo.vip，检查是否出现 /v1/v1。 |
| 充值后仍失败 | 余额未到账、登录了错误账号、使用了旧密钥。 | 刷新余额，核对账号和 API Key，必要时携带订单号联系支持。 |
12. 安全和使用规范
- 不要把 API Key 发给他人，不要截图公开，不要提交到 GitHub 或其他公开仓库。
- 不要在网页前端、浏览器源码或移动端包里硬编码 API Key。
- 生产环境使用服务端代理或后端服务调用，密钥放在环境变量或密钥管理系统中。
- 不同软件、不同项目、不同环境使用不同 API Key，方便发现问题后单独停用。
- 定期查看用量和余额，发现异常消耗及时停用对应密钥。
- 不要无限重试失败请求，避免因为循环请求造成额外消耗。
13. 生产环境建议
- 测试环境和生产环境使用不同 API Key。
- 设置合理超时时间，避免请求长时间挂起。
- 对 429、网络错误和 5xx 使用有限次数重试，不要对 401、403、模型不存在进行重复重试。
- 记录请求时间、模型、密钥名称、状态码和错误信息，但不要记录完整 API Key。
- 上线前用小流量测试模型、号池、扣费和错误处理。
- 定期检查余额提醒和用量趋势，避免余额耗尽影响业务。
14. 联系支持前准备
如果问题无法自行解决，请准备脱敏信息，支持人员才能快速定位。
- 出现问题的北京时间，精确到分钟。
- 使用的软件名称和版本，例如 Claude Code、Chatbox 或自研服务。
- Base URL、模型名、分组名和密钥名称，注意不要提供完整 API Key。
- 错误状态码、错误信息截图或请求 ID。
- 充值问题需要提供订单号、支付时间和账号邮箱。
- 扣费问题需要提供用量记录时间、模型和大致请求内容类型。
15. 推荐日常流程
- 先确认余额余额充足后再进行批量任务或长任务。
- 再确认模型从控制台复制当前账号可用模型 ID。
- 使用独立密钥每个软件或项目一把 Key，便于统计和停用。
- 小请求测试先发送短问题，确认响应、扣费和日志正常。
- 正式使用长期使用时定期查看余额、用量、失败记录和模型状态。