RovoAPI
Back to docs

快速开始

跑通第一次真实 API 调用

快速开始

RovoAPI 是一个通用 AI API 网关，只需一个 API Key 和一个端点，即可接入 Claude、GPT、Gemini 和 DeepSeek 等主流模型。

这一页只做一件事：让你用真实的 API Key 跑通一次真实的请求，亲眼看到它能用。不讲原理——原理在工作原理那页。

1. 创建账号 ~1 分钟

前往 rovoapi.com 注册，API Key 即时生成，格式如下：

sk-rov...f456

提示：注册即送 $1 测试金，无需充值即可体验。

在开始之前，先看你的情况

你现在属于哪一种？

  • 你已经用 Anthropic / OpenAI 官方 SDK 写好了代码 → 接 RovoAPI 只是改两个参数（api_key 和 base_url），代码逻辑完全不动。跳到第三步就行。
  • 你用 Claude Code（命令行编程工具），要让它走 RovoAPI → 看下面 cc-switch 部分，这是目前国内用户最常用的方式。
  • 你第一次接触 AI API，什么都不懂 → 跟着完整走一遍，5 分钟搞定。

第一步：拿到 API Key

去 rovoapi.com/register 注册，不需要信用卡。

注册完成后，控制台会立刻生成一个 Key，长这样：

sk-rovo-abc123...f456

现在就复制它。 下面每一步都要用到。

API Key 是什么？ 它是 RovoAPI 识别你身份的方式。每次请求时带上它，系统才知道是谁在调用、该扣谁的余额。类比门禁卡——刷卡才能进门。

第二步：充值

最低充值 ¥10，支持信用卡和支付宝。余额不过期，用多少扣多少。

只是想先测试能不能跑通？可以跳过这步直接试——没有余额时调用会返回 402 错误，但你能确认 Key 本身是有效的。

第三步：配置你的工具

根据你用的工具选对应的方法。

如果你用 Claude Code（重点）

国内开发者用 Claude Code，几乎都会遇到同一个问题：Claude Code 默认连接 Anthropic 官方服务器，在中国大陆访问慢、不稳定，甚至连不上。

解决办法是把它指向 RovoAPI 的服务器。说白了就是改两个配置：

| 配置项 | 含义 | 默认值（官方） | 改成 RovoAPI | |--------|------|---------------|-------------| | ANTHROPIC_API_KEY | "你是谁" | 你的 Anthropic Key | 你的 RovoAPI Key | | ANTHROPIC_BASE_URL | "请求发到哪" | https://api.anthropic.com | https://api.rovoapi.com |

下面三种方式，本质做的都是同一件事——改这两个值。

方式 A：用 cc-switch 桌面工具（推荐新手）

cc-switch 是一个独立的开源桌面工具（github.com/farion1231/cc-switch），专门用来管理 Claude Code、Codex、Gemini CLI 等 AI 工具的供应商配置。它不是 RovoAPI 的工具，也不是 Claude Code 自带的——它是一个社区开发的第三方工具，你可以把它理解为"配置文件的可视化管家"。

很多新手以为 cc-switch 是 RovoAPI 的一部分，其实不是。它只是一个通用的配置切换器，你可以在里面管理任意多个 API 供应商，包括 Anthropic 官方、AWS Bedrock、各种中转站等等。

安装：

  • macOS：brew install --cask cc-switch，或从 ccswitch.io 下载
  • Windows / Linux：从 ccswitch.io 下载安装包

添加 RovoAPI 供应商：

  1. 打开 cc-switch，点击 添加供应商（"+" 按钮）
  2. 填入以下信息：

| 字段 | 填写内容 | |------|---------| | 供应商名称 | RovoAPI（随便填，你认得就行）| | Base URL | https://api.rovoapi.com | | API Key | sk-rovo-你的Key | | 模型 | claude-sonnet-5 |

  1. 目标应用选择 Claude Code
  2. 保存

回到主界面，找到 RovoAPI，点击 启用。之后终端里 claude code 就自动走 RovoAPI 了。

想切回官方？ 在 cc-switch 里选 Anthropic Official 预设，启用就行。

Base URL 到底是什么意思？ 直译是"基础地址"。Claude Code 默认向 https://api.anthropic.com 发请求——这是 Anthropic 官方的地址。改成 https://api.rovoapi.com 后，请求就发到 RovoAPI 了。RovoAPI 收到后帮你转交给真正的 Claude 模型。就跟你改快递收货地址一样简单。

方式 B：手动改配置文件

Claude Code 的配置在 ~/.claude/settings.json。用任意编辑器打开，写入：

{
  "env": {
    "ANTHROPIC_API_KEY": "sk-rovo-你的Key",
    "ANTHROPIC_BASE_URL": "https://api.rovoapi.com"
  }
}

保存后重新打开终端，运行 claude code。

方式 C：一键脚本

curl -fsSL https://rovoapi.com/setup.sh | bash

脚本会检测你的系统、让你输入 API Key、自动写入配置。约 30 秒。

如果你用代码（Python / Node.js 等）

选你正在用的 SDK：

Anthropic SDK（改两行）：

import anthropic

client = anthropic.Anthropic(
    api_key="sk-rovo-你的Key",          # 原来是你的 Anthropic Key
    base_url="https://api.rovoapi.com"  # 加上这一行
)

msg = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "你好"}],
)
print(msg.content[0].text)

OpenAI SDK（也是改两行）：

from openai import OpenAI

client = OpenAI(
    api_key="sk-rovo-你的Key",
    base_url="https://api.rovoapi.com/v1"
)

response = client.chat.completions.create(
    model="claude-sonnet-5",
    messages=[{"role": "user", "content": "你好"}]
)
print(response.choices[0].message.content)

建议：claude-sonnet-5 性价比最高。

注意区分：Anthropic SDK 的 base_url 末尾不带 /v1，OpenAI SDK 的 base_url 末尾带 /v1。写错的话会返回 404。

如果你还没有任何代码，先用终端测

curl https://api.rovoapi.com/v1/chat/completions \
  -H "Authorization: Bearer sk-rovo-你的Key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-flash",
    "messages": [{"role": "user", "content": "用5个词打个招呼"}]
  }'

这里用 deepseek-v4-flash 是因为它最便宜（$0.14/M 输入），测试阶段几乎不花钱。

第四步：确认成功了

跑完上面任意一种方式，你会看到类似这样的返回：

Anthropic SDK 返回：

你好！有什么可以帮助你的吗？

cURL / OpenAI SDK 返回：

{
  "choices": [{"message": {"content": "你好！有什么可以帮助你的吗？"}}]
}

看到内容，说明从你的代码 → RovoAPI → 上游模型 → 返回给你，整条链路跑通了。

没看到？按表查

| 报错 | 真实原因 | 怎么修 | |------|----------|--------| | 401 Unauthorized | Key 写错了，或者没复制完整 | 回控制台重新复制 Key，注意不要有多余空格 | | 402 Payment Required | 余额不足 ¥10 | 去控制台充值 | | 429 Too Many Requests | 请求太密集 | 等几秒重试。持续出现的话去控制台看限速档位 | | 请求卡住不返回 | 网络问题 | 检查本地网络，或换一个网络环境 | | 返回内容和预期模型不符 | model 字段拼写错了 | 对照模型列表检查模型名 |

跑通之后，你可能想问

「cc-switch 和 claude switch 有什么区别？」

它们是两个完全不同的东西：

  • cc-switch 是一个开源桌面工具（farion1231/cc-switch），有图形界面，可以管理多个 AI 工具的 API 配置。它不是 RovoAPI 的一部分，也不是 Claude Code 的一部分。
  • claude switch 是 Claude Code 自带的一个命令行，也能切换配置，但操作方式不同，功能也更基础。

它们做的事本质一样——改 ANTHROPIC_BASE_URL 和 ANTHROPIC_API_KEY。区别只是操作方式：一个有界面，一个打命令。

「我改了 base_url，为什么代码其他地方完全不用动？」

因为 RovoAPI 不改请求/响应格式，只做转发。你发给我的 JSON 是什么结构，我原样转给上游；上游返回什么，我原样返回给你。所以官方 SDK 不需要任何适配。

「生产环境前还要做什么？」

三件事：流式响应（stream: true）、错误重试（指数退避）、用量监控。具体看 API 参考 的最佳实践部分。

下一步

  • 工作原理 — 搞清楚数据流向和故障处理，接入生产前建议先看
  • 模型列表 — 所有模型的价格和适用场景对比
  • API 参考 — 完整端点、流式输出、错误码
  • 常见问题 — 更多疑问解答

卡住了？ 发邮件到 [email protected]，我们几小时内回复。

工作原理