快速开始

按下面四步，几分钟就能用上 Rabah。

1. 注册并登录

打开 Rabah Hub，注册账号并登录。

2. 充值或订阅

在左侧菜单 充值/订阅 里选择：

• 余额：按实际用量扣费，用多少扣多少。
• 订阅：按套餐包含的额度使用。

两种方式可以同时有。每个密钥可以单独设置从哪里扣费，见下一步。

3. 创建 API 密钥

进入 API 密钥 → 创建密钥。第一次使用，通常只需要填一个名称，其他保持默认：

选项	默认值	说明
线路与模型	全部线路和模型	这个密钥能调用你可用的所有模型，以后新增的线路也包括在内。
计费来源	余额	有订阅时可以改成订阅，并可勾选”订阅额度用完或过期后自动使用余额”。
额度、速率限制、有效期	不限制	想控制这个密钥最多花多少钱时再设置。

创建后复制密钥，系统生成的密钥以 sk- 开头。密钥就是你的账户凭证，不要发给别人，也不要提交到代码仓库。

4. 配置客户端

在密钥列表里点 使用密钥，选择你要用的客户端，复制对应的配置：

• 通用：OpenAI 兼容地址和 Anthropic 地址，适合大多数应用和 SDK。
• Codex CLI、Claude Code、Gemini CLI、OpenCode：每个客户端的完整配置文件。

这里显示的配置已经填好了你的密钥和正确的地址，直接复制即可。

用 Rabah Desktop 一键配置

如果你在 Windows 或 macOS 电脑上使用 Claude Code 或 Codex，可以点密钥旁边的 一键配置，在 Rabah Desktop 中确认后自动写入配置，不用手动编辑文件。详见 一键配置。

测试一下

在终端里运行下面这条命令，把 你的密钥 换成刚才复制的密钥：

curl https://api.rabah.ai/v1/models \
  -H "Authorization: Bearer 你的密钥"

返回一串模型列表，说明密钥和地址都没问题。这个请求不消耗额度。

再试一次真正的对话，把 MODEL_NAME 换成 模型广场 里的模型名：

curl https://api.rabah.ai/v1/chat/completions \
  -H "Authorization: Bearer 你的密钥" \
  -H "Content-Type: application/json" \
  -d '{"model": "MODEL_NAME", "messages": [{"role": "user", "content": "你好"}]}'

请求成功后，可以在 Hub 的 使用记录 里看到这次调用的模型、用量和费用。

下一步

• 接入地址与认证：各接口的地址、密钥的几种传法、如何指定线路。
• 客户端配置：Codex CLI、Claude Code、Gemini CLI、OpenCode、其他应用。