从注册到首次调用

本页按新用户的实际操作顺序编写。先完成账号、余额、密钥和分组，再复制一条请求验证链路。

1. 注册并登录

打开站点首页，点击“注册”，填写邮箱、密码和邀请码（如果管理员开启了邀请码）。完成验证码后登录。

先确认站点地址

只在你信任的官方域名输入密码和 API Key。不要把 API Key 发到群聊、工单或截图中。

页面上的注册、登录、验证码和第三方登录选项以当前站点配置为准。

2. 充值或确认订阅

进入“充值”或“订阅”页面：

1. 余额计费适合测试和按量使用。
2. 订阅适合固定分组、固定周期的高频使用。
3. 付款完成后回到“余额”或“订阅”页面确认状态。

金额、手续费、最低充值金额和分组倍率以站内显示为准。

3. 创建 API Key

进入“API 密钥”页面，点击“创建密钥”：

字段	新手建议
名称	用途，例如 我的 Codex
分组	选择与模型平台匹配的公开分组
额度	第一次先使用默认值
有效期	长期使用可留空或选择较长周期
IP 限制	不确定时先不限制，确认可用后再加

保存后只会完整显示一次密钥，请立即复制到密码管理器。

4. 选择模型和分组

分组决定请求可以调度到哪类上游：

• OpenAI：Chat Completions、Responses、OpenAI 生图。
• Anthropic：Claude Messages 和 Claude Code。
• Gemini：Gemini 原生 v1beta 接口。
• Grok：文本、图片、语音或视频，取决于分组和账号能力。
• Seedance：视频任务和素材接口。

不要只根据模型名称判断权限；如果返回 model_not_found 或 permission_error，先检查 API Key 的分组和分组状态。

5. 用 curl 发起第一条请求

把下面三个变量替换成自己的值：

export BASE_URL="https://api.ruikon.com"
export API_KEY="sk-替换为你的密钥"
export MODEL="替换为分组中可用的模型"

curl "$BASE_URL/v1/chat/completions" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"model\":\"$MODEL\",\"messages\":[{\"role\":\"user\",\"content\":\"用一句话介绍你自己\"}]}"

看到 choices[0].message.content 就说明基本链路已经打通。

6. 查看请求记录

回到“使用记录”检查：

• 模型和分组是否正确。
• 请求是否成功。
• 输入、输出和缓存 Token。
• 标准费用与实际费用。
• 首字时间、总耗时和上游错误。

如果请求成功但余额没有变化，先等待账单异步落库，再刷新页面。

7. 下一步

• 使用 Agent：阅读 Agent 接入总览。
• 调用接口：阅读 API 调用约定。
• 复制多语言代码：阅读 完整示例。