GETTING STARTED

快速开始

按照下面步骤完成首次接入：账号登录、充值、创建 API Key、选择号池、配置 Base URL、发送测试请求。

1. 注册或登录

打开 https://keygo.vip/。
使用邮箱注册账号，按页面提示完成验证。
登录后先进入个人中心或控制台首页，确认账号状态正常。

2. 充值并确认余额

进入控制台的充值页面。
选择充值金额并完成支付。
返回控制台确认余额到账。余额不足时，请求可能返回额度或余额相关错误。

建议：首次接入先小额充值并做一次测试调用，确认模型、号池和软件配置都正确后再用于正式任务。

3. 了解号池和分组

KeyGo 通过分组控制不同号池、倍率、稳定性和可见范围。创建 API Key 时应选择适合当前用途的分组。

类型	说明	使用建议
普通组	默认对普通用户可见，适合常规使用。	优先用于日常聊天、开发、轻量任务和测试。
稳定组	通常倍率更高，但可用性、稳定性或资源质量更好。	用于重要任务、长上下文任务和对失败率敏感的场景。
专属组	需要显式授权才可见，普通用户和管理员都遵循授权规则。	用于内部测试、特殊客户、私有号池或低倍率资源。

4. 创建 API Key

进入控制台的 API Key 或密钥管理页面。
点击创建密钥，填写便于识别的名称，例如 claude-code-macbook 或 chatbox-home。
选择要使用的分组或号池。不同密钥可以绑定不同分组，便于统计和隔离风险。
创建后立即保存完整密钥。密钥通常只显示一次。

5. 设置统一 Base URL

新配置统一使用：

https://keygo.vip

不要主动在 Base URL 后面添加 /v1。如果某个老软件强制要求 /v1，可以临时使用兼容地址 https://keygo.vip/v1。

6. 发送测试请求

将 YOUR_KEYGO_API_KEY 替换为控制台生成的密钥，将 YOUR_MODEL_NAME 替换为控制台里你可用的模型名。

curl 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": "你好，请用一句话介绍 KeyGo。"}
    ]
  }'

7. 验证结果

请求返回正常内容，说明 Base URL、密钥和模型名基本正确。
控制台用量记录出现对应调用，说明计费链路正常。
如果返回 401、403、429 或模型不存在，先阅读常见问题。

下一步

如果你使用 Claude Code、Chatbox、Cherry Studio、NextChat 或其他客户端，请继续阅读软件配置。如果你要在服务端代码中调用，请阅读 API 接入。