创建 API Key

前置条件

• 已注册并登录控制台。
• 已确定客户端使用的协议：OpenAI 兼容、Anthropic 兼容还是 Gemini 兼容。

步骤

1. 进入控制台的 API Keys 页面。
2. 新建密钥，填写名称。名称只用于自己区分用途，不影响调用。
3. 选择服务分组。分组决定这把密钥可以调用的模型范围与计费口径，请选择与客户端协议匹配的分组。
4. 按需设置额度上限与有效期。给团队成员分发密钥时，用额度上限隔离各自的用量。
5. 按需设置 IP 允许列表。设置后，来自列表之外的 IP 会被拒绝并返回 403。
6. 保存后，在密钥列表中点击密钥查看完整值，或使用旁边的复制按钮。密钥形如 sk- 开头的一串字符，请妥善保管。

配置示意图，非控制台截图。名称可自定义，分组以账户实际可选项为准；点击图片查看大图。

把密钥写入环境变量，不要提交进代码仓库：

export ROIBEST_API_KEY="sk-your-key"

验证

curl https://ai.roibest.com/v1/models \
  -H "Authorization: Bearer $ROIBEST_API_KEY"

返回一个包含 data 数组的 JSON，说明密钥可用。数组里就是这把密钥当前能调用的模型。

常见问题

密钥丢了怎么办？ 登录控制台，在 API Keys 列表中查看或复制原密钥。如果怀疑已泄露，请删除旧密钥并新建一把，然后更新客户端配置。

一把密钥能同时用 OpenAI 和 Anthropic 协议吗？ 取决于密钥所属分组开放的模型。分组同时开放了两类模型时可以，否则请为每套协议各建一把密钥。

返回 401 且提示令牌无效。 检查密钥是否含多余空格、是否已过期或被禁用，以及请求头是否写成了 Authorization: Bearer sk-...。

返回 403 且提示 IP 不在允许列表中。 密钥配置了 IP 允许列表，而当前出口 IP 不在其中。到密钥设置里补充该 IP 或清空列表。