五分钟接通

前置条件

• 已按创建 API Key 拿到密钥，并写入 ROIBEST_API_KEY。
• 已知道要调用的模型名。不确定时先用 /v1/models 列一下，见下方验证步骤。

步骤

操作流程示意图。your-model 不是实际模型名，需替换为密钥可调用的模型；点击图片查看大图。

1. 创建对应协议的 API Key

在控制台创建密钥时选择与客户端协议匹配的服务分组，按需设置额度与有效期。

2. 替换 Base URL

把客户端里指向厂商官方地址的配置换成网关地址：

客户端使用的协议	原地址	换成
OpenAI 兼容	https://api.openai.com/v1	https://ai.roibest.com/v1
Anthropic 兼容	https://api.anthropic.com	https://ai.roibest.com
Gemini 兼容	https://generativelanguage.googleapis.com/v1beta	https://ai.roibest.com/v1beta

Anthropic 生态的 SDK 和 Claude Code 会自己拼 /v1/messages，所以填根地址，不要带 /v1。

3. 选择模型并调用

OpenAI 兼容（Chat Completions）：

curl https://ai.roibest.com/v1/chat/completions \
  -H "Authorization: Bearer $ROIBEST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "your-model",
    "messages": [{"role": "user", "content": "Hello"}]
  }'

Anthropic 兼容（Messages）：

curl https://ai.roibest.com/v1/messages \
  -H "x-api-key: $ROIBEST_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "your-model",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello"}]
  }'

Gemini 兼容：

curl "https://ai.roibest.com/v1beta/models/your-model:generateContent" \
  -H "x-goog-api-key: $ROIBEST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"contents": [{"parts": [{"text": "Hello"}]}]}'

验证

先确认密钥能列出模型，再确认能真正产生一次调用：

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

调用成功后，到控制台的用量明细里应能看到这条请求，含模型、分组、输入输出 Token、计费方式、费用和延迟。

常见问题

接入时到底要改什么？ 只改两处：Base URL 和密钥。再从该分组开放的模型里挑一个填进 model。

model 填什么？ 填 /v1/models 返回的 id。模型广场也会列出当前可用模型与参考价格。

返回 404 或提示 model_not_found。 模型名拼错，或该模型不在密钥所属分组的开放范围内。换一个 /v1/models 里出现过的名字。

用 Anthropic SDK 时报路径错误。 Base URL 多带了 /v1。Anthropic 侧填根地址 https://ai.roibest.com。