快速入门

EasyRouter 是一个 AI 模型统一接入网关，兼容 OpenAI API 格式。你只需要一个 API Key 和一个 Base URL，就能通过同一套接口调用 GPT、Claude、Gemini、DeepSeek 等近百种主流 AI 模型，无需为每家服务商单独管理账号和密钥。

无论你是直接通过代码调用 API，还是使用 Claude Code、OpenClaw 等客户端工具，接入方式都一样简单。

一、五分钟接入三步走

Step 1 — 获取你的 API Key

1.1 登录 EasyRouter 控制台

打开 https://easyrouter.io，使用 Google、GitHub 或 Discord 账号登录后进入控制台。

1.2 进入 API Key 管理，创建密钥

在左侧导航点击「API Key 管理」进入管理页面。

点击「创建 API Key」按钮，在弹窗中配置以下信息：

• 密钥名称：给这个密钥起个名字（如 my-first-key）
• 分组：可选，按项目或用途分类管理（非必填）
• 新建数量：默认创建 1 个，可根据需要调整
• 额度设置：选择「无限额度」或设置单次请求的最大额度限制
• 其他选项：如需要可配置有效期、IP 白名单等

点击「提交」按钮，密钥即刻生成。

1.3 复制你的 API Key

创建成功后，在列表中找到你的 API Key，右键点击并选择相应选项：

• 「复制密钥」：复制 API Key（以 sk- 开头）
• 「复制链接信息」：一键复制包括 Base URL 和 API Key 的完整配置

你获得的信息包括：

• Base URL：https://easyrouter.io（你的接入地址，所有 API 调用都用这个）
• API Key：以 sk- 开头的密钥

Step 2 — 调用第一个 API

EasyRouter 采用与 OpenAI API 完全兼容的 API 格式。通过修改配置，您可以使用标准的 OpenAI SDK，或任何与 OpenAI API 兼容的第三方客户端与工具来无缝调用 EasyRouter 聚合的所有大模型。

2.1 查看可用模型

可在模型广场浏览所有可用模型。

若需要在代码中动态获取可用模型列表，可以直接调用 models 接口：

curl https://easyrouter.io/v1/models \
  -H "Authorization: Bearer sk-你的APIKey"

返回结果中的 id 字段即为模型名称。

2.2 调用第一个模型

选定模型后，填入 model 参数即可发起调用。以下以 gemini-2.5-flash 为例：

curl https://easyrouter.io/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-你的APIKey" \
  -d '{
    "model": "gemini-2.5-flash",
    "messages": [
      {"role": "user", "content": "你好，介绍一下你自己"}
    ]
  }'

from openai import OpenAI

client = OpenAI(
    base_url="https://easyrouter.io/v1",
    api_key="sk-你的APIKey"
)

response = client.chat.completions.create(
    model="gemini-2.5-flash",
    messages=[
        {"role": "user", "content": "你好，介绍一下你自己"}
    ]
)

print(response.choices[0].message.content)

Step 3 — 接入你的工具

EasyRouter 支持所有兼容 OpenAI API 的客户端和工具，接入三要素：

Claude Code / Codex CLI

命令行代码助手。

在终端使用 Claude Code 或 Codex CLI 时，设置以下环境变量：

# Claude Code
export ANTHROPIC_BASE_URL="https://easyrouter.io"
export ANTHROPIC_API_KEY="sk-你的APIKey"

# Codex CLI
export OPENAI_BASE_URL="https://easyrouter.io/v1"
export OPENAI_API_KEY="sk-你的APIKey"

详细教程：Claude Code · Codex CLI

OpenClaw

自托管 AI 助手平台，进阶用户推荐。

OpenClaw 是一个自托管 AI 助手平台，支持 Telegram、Discord、Feishu 等多渠道接入。在 ~/.openclaw/openclaw.json 中添加以下配置：

{
  "models": {
    "mode": "merge",
    "providers": {
      "easyrouter": {
        "baseUrl": "https://easyrouter.io/v1",
        "apiKey": "sk-你的APIKey",
        "api": "openai-completions",
        "models": [
          { "id": "gemini-2.5-flash", "name": "Gemini 2.5 Flash" },
          { "id": "claude-sonnet-4-6", "name": "Claude Sonnet 4.6" }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "easyrouter/gemini-2.5-flash"
      }
    }
  }
}

详细教程：OpenClaw

Cherry Studio

桌面 AI 客户端，推荐新手使用。

Cherry Studio 是一款功能丰富的桌面 AI 聊天客户端，支持多模型对话。

1. 下载并安装 Cherry Studio：https://cherry-ai.com/download
2. 打开「设置」→「模型服务商」→ 添加服务商
3. 服务商类型选择 OpenAI（或兼容 OpenAI 的选项）
4. API 地址填写：https://easyrouter.io
5. API Key 填写你的令牌
6. 添加你想使用的模型 ID（可从 /v1/models 查询）

详细图文教程：Cherry Studio

其他 OpenAI 兼容工具

任何支持自定义 API 地址的工具，只需按如下三项配置即可接入：

• API 地址 / Base URL → https://easyrouter.io
• API Key → 你在控制台创建的令牌
• 模型名称 → 从 /v1/models 查询后填写

更多已验证的应用接入指南：接入 Agent 工具

二、API 能力一览

EasyRouter 提供以下 AI 模型 API，均兼容 OpenAI 格式：

完整 API 文档：API 文档

三、常见问题