快速入门
五分钟接入 EasyRouter — 获取 API Key，调用第一个 AI 模型，连接你的工具。
EasyRouter 是一个 AI 模型统一接入网关，兼容 OpenAI API 格式。你只需要一个 API Key 和一个 Base URL，就能通过同一套接口调用 GPT、Claude、Gemini、Kimi 等数十种主流 AI 模型，无需为每家服务商单独管理账号和密钥。
无论你是直接通过代码调用 API，还是使用 Claude Code、OpenClaw 等客户端工具，接入方式都一样简单。
一、五分钟接入三步走
Step 1 — 获取你的 API Key
1.1 登录 EasyRouter 控制台
打开 https://easyrouter.io，使用 Google 邮箱登录后进入控制台。
1.2 进入令牌管理，创建令牌
在左侧导航点击「令牌管理」，点击右上角「创建令牌」按钮。
填写令牌名称（如 my-first-key），按需设置有效期等基础信息，然后确认创建。
1.3 复制 Base URL 和 API Key
令牌创建后，在令牌列表中可以直接看到：
- Base URL：
https://easyrouter.io（你的接入地址，所有 API 调用都用这个） - API Key：以
sk-开头的密钥（只显示一次，请立即复制保存）
重要提示
API Key 创建后只显示一次，请妥善保存。如果丢失，需要重新创建令牌。
Step 2 — 调用第一个 API
EasyRouter 与 OpenAI API 完全兼容，任何支持 OpenAI 的 SDK 或工具，只需把 base_url 和 api_key 换成 EasyRouter 的即可。
2.1 用 curl 快速验证
curl https://easyrouter.io/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-你的APIKey" \
-d '{
"model": "gpt-4o",
"messages": [
{"role": "user", "content": "你好，介绍一下你自己"}
]
}'2.2 用 Python（openai SDK）
from openai import OpenAI
client = OpenAI(
base_url="https://easyrouter.io/v1",
api_key="sk-你的APIKey"
)
response = client.chat.completions.create(
model="gpt-4o",
messages=[
{"role": "user", "content": "你好，介绍一下你自己"}
]
)
print(response.choices[0].message.content)2.3 查询可用模型列表
想知道 EasyRouter 当前开放了哪些模型？调用 /v1/models 接口：
curl https://easyrouter.io/v1/models \
-H "Authorization: Bearer sk-你的APIKey"返回的 id 字段即为调用时使用的 model 参数值。
Step 3 — 接入你的工具
EasyRouter 支持所有兼容 OpenAI API 的客户端和工具，接入三要素：
| 参数 | 值 |
|---|---|
| API 地址（Base URL） | https://easyrouter.io |
| API Key | 你在控制台创建的令牌 |
| 模型名称 | 从 /v1/models 查询，或参考控制台模型列表 |
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": "gpt-4o", "name": "GPT-4o" },
{ "id": "claude-3-5-sonnet", "name": "Claude 3.5 Sonnet" }
]
}
}
},
"agents": {
"defaults": {
"model": {
"primary": "easyrouter/gpt-4o"
}
}
}
}详细教程：OpenClaw
Cherry Studio
桌面 AI 客户端，推荐新手使用。
Cherry Studio 是一款功能丰富的桌面 AI 聊天客户端，支持多模型对话。
- 下载并安装 Cherry Studio：https://cherry-ai.com/download
- 打开「设置」→「模型服务商」→ 添加服务商
- 服务商类型选择
OpenAI（或兼容 OpenAI 的选项） - API 地址填写：
https://easyrouter.io - API Key 填写你的令牌
- 添加你想使用的模型 ID（可从
/v1/models查询）
一键填入
EasyRouter 控制台令牌管理页支持「一键填入 Cherry Studio」快捷操作，在令牌列表点击后 Cherry Studio 会自动填充配置，无需手动输入。
详细图文教程：Cherry Studio
其他 OpenAI 兼容工具
任何支持自定义 API 地址的工具，只需按如下三项配置即可接入：
- API 地址 / Base URL →
https://easyrouter.io - API Key → 你在控制台创建的令牌
- 模型名称 → 从
/v1/models查询后填写
更多已验证的应用接入指南：接入 Agent 工具
二、API 能力一览
EasyRouter 提供以下 AI 模型 API，均兼容 OpenAI 格式：
| API | 端点 | 说明 |
|---|---|---|
| 对话补全 | POST /v1/chat/completions | 多轮对话，支持流式输出（stream: true）、Tool Calling、结构化输出 |
| 文本补全 | POST /v1/completions | 传统文本补全接口 |
| 图像生成 | POST /v1/images/generations | AI 图像生成 |
| 视频生成 | POST /v1/videos | AI 视频生成 |
| 模型列表 | GET /v1/models | 查询当前可用模型 |
完整 API 文档：API 文档