快速开始

本平台是 AI 模型统一接入网关，兼容 OpenAI API 格式。只需一组 Base URL 与 API Key，即可通过同一套接口调用 GPT、Claude、Gemini、Kimi 等主流模型，无需分别为各家服务商维护账号与密钥。

一、快速上手

建议按下列步骤依次完成注册、创建密钥与连通性验证。每一步均附操作截图与完成标志，便于对照检查。

使用说明

1. 请按 第 1 步 → 第 6 步 顺序操作，避免跳步。
2. 对照每步的 预期结果 与 完成标志，确认是否配置成功。
3. 配图为真实界面截图，请跟随红框标注逐步操作。
4. 全程只需准备下表三项信息：

第 1 步：打开网站

1.1 打开首页

预期结果 — 页面正常显示；右上角或显眼位置可见 「登录」 入口。

第 2 步：注册账号并登录

2.1 注册（没有账号时）

预期结果 — 出现注册成功提示，或自动跳转至登录页 / 控制台。

2.2 登录（已有账号）

2.3 进入控制台

✅ 第 2 步完成标志： 已成功登录，左侧菜单可见「API 密钥」「游乐场」等入口。

第 3 步：创建 API 密钥

密钥是调用 AI 接口的身份凭证，后续所有客户端与代码请求均需携带。

3.1 打开 API 密钥页

预期结果 — 页面标题为「API 密钥」；右上角有 「创建 API 密钥」 按钮。

3.2 创建密钥

3.3 填写表单

3.4 复制并保存

⚠️ 重要： 密钥通常 仅完整显示一次。请勿分享至公开渠道；若发生泄露，请立即禁用并重新创建。

✅ 第 3 步完成标志： 已妥善保存「API 地址」与「API 密钥」。

第 4 步：验证连通

在控制台通过游乐场完成一次对话，确认密钥与模型可用。

预期结果 — 收到 AI 的文字回复。

✅ 第 4 步完成标志： 游乐场中收到 AI 回复。

第 5 步：获取模型名称

✅ 第 5 步完成标志： 已记录至少一个可用模型名称。

第 6 步（可选）：接入 Cherry Studio

本节以 Cherry Studio 为例，演示如何将平台接入桌面聊天客户端。
亦可选用 Claude Desktop、ChatBox 等 OpenAI 兼容 客户端，填写相同的 API 地址、密钥与模型名称即可。

6.1 安装客户端

1. 访问 Cherry Studio 下载页 并完成安装。

6.2 添加服务商

6.3 填写接入信息

6.4 从模型库添加模型

预期结果 — 模型列表中出现 gpt-5.4。

6.5 手动添加模型（搜索不到时）

6.6 测试对话

保存配置后，点击 首页，选择模型，发送 你好，应收到 AI 回复。

✅ 第 6 步完成标志： 在 Cherry Studio（或其他客户端）中可正常对话。

二、开发者接入说明

完成上文快速上手后，若你希望通过 SDK 或命令行 将平台集成到自有应用，可参考本节示例。平台与 OpenAI API 完全兼容，将 base_url 与 api_key 替换为你的配置即可调用。

2.1 准备工作

调用前请确认以下三项（对应上文第 3、5 步）：

2.2 使用 curl 验证

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

2.3 使用 Python SDK

from openai import OpenAI

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

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

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

2.4 查询可用模型

调用 GET /v1/models 可获取当前账户可用的模型列表：

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

返回结果中 id 字段即为调用时的 model 参数值。

三、接入你的工具

平台支持所有兼容 OpenAI API 的客户端与开发工具。接入时只需配置以下三要素：

3.1 接入三要素

3.2 Claude Code / Codex CLI

适用于命令行代码助手场景。在终端中设置以下环境变量：

export OPENAI_API_KEY="sk-你的APIKey"
export OPENAI_BASE_URL="https://autorouter.top/v1"

3.3 OpenClaw

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

{
  "models": {
    "mode": "merge",
    "providers": {
      "autorouter": {
        "baseUrl": "https://autorouter.top/v1",
        "apiKey": "sk-你的APIKey",
        "api": "openai-completions",
        "models": [
          { "id": "gpt-5.4", "name": "GPT-5.4" }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "autorouter/gpt-5.4"
      }
    }
  }
}

3.4 其他 OpenAI 兼容工具

任何支持自定义 API 地址的工具，按以下映射填写即可：

• API 地址 / Base URL → https://autorouter.top
• API Key → 控制台创建的 API 密钥
• 模型名称 → 通过 /v1/models 查询后填写

更多已验证的应用接入指南，请参阅文档站「接入 Agent 工具」。

四、API 能力一览

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

完整接口说明请参阅 API 文档。

五、遇到问题？

六、更多帮助