跳到主要内容
Router One
跳到主要内容
Router One

Router One 使用文档

从注册到接入的完整指南，让你尽快用上统一的 LLM API 网关。

开始使用

  1. 1

    注册账号

    打开注册页，创建你的 Router One 账号。

    注册
  2. 2

    创建 API Key

    进入控制台 →「API 密钥」页面，为项目生成独立 Key。

    API Keys
  3. 3

    发送第一个请求

    用 curl、OpenAI SDK 或 Anthropic SDK，在 Header 里带上 Authorization: Bearer <key>。

    快速开始

一键接入（推荐）

一条命令完成安装 CLI、写入网关配置、并用 1 token 测试请求验证 Key。已有配置文件会自动备份。

创建 API Key

Key 只在浏览器本地拼进命令，不会被上传。

bash
curl -fsSL https://router.one/install/claude-code.sh | bash -s -- sk-your-api-key

配置立即生效，运行 claude 即可开始使用。

powershell
$env:ROUTER_ONE_API_KEY = "sk-your-api-key"; irm https://router.one/install/claude-code.ps1 | iex

配置立即生效，运行 claude 即可开始使用。

运行前可先查看脚本源码： /install/claude-code.sh · /install/claude-code.ps1

bash
curl -fsSL https://router.one/install/codex.sh | bash -s -- sk-your-api-key

新开的终端可直接运行 codex；当前终端先执行 source ~/.zshrc（或对应 shell 配置）。

powershell
$env:ROUTER_ONE_API_KEY = "sk-your-api-key"; irm https://router.one/install/codex.ps1 | iex

当前会话已生效，直接运行 codex 即可。

运行前可先查看脚本源码： /install/codex.sh · /install/codex.ps1

接入客户端，确认请求结果

客户端接入指南

找到你的编程工具、SDK 或聊天应用，核对地址字段与协议，再按指南完成配置。

连接排查指南

首个请求失败时，依次检查 URL、DNS、TLS、HTTP 响应和模型结果。

读懂请求日志

了解请求 ID、HTTP 状态、token、结算与延迟。收到 200 响应不代表流式回答已经完成。

请求示例

bash
curl https://api.router.one/v1/chat/completions \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "auto",
    "messages": [{"role": "user", "content": "你好"}]
  }'

Router One 是什么？

Router One 是一个统一的 LLM API 网关。它提供一个 OpenAI 兼容端点，用来统一处理模型调用、智能路由、自动故障转移、预算控制和每请求观测。

核心价值

用同一个 API Key 和 Base URL 接入常用 AI 编程工具和模型。不同供应商的接口差异、成本追踪和路由策略由 Router One 在网关层处理。

主站按量计费入口：

text
OpenAI 兼容 API / Codex CLI / OpenClaw / Hermes Agent:
https://api.router.one/v1

Claude Code / Anthropic 兼容端点:
https://api.router.one

API 参考

对话生成

POST/v1/chat/completions

创建聊天补全 — 兼容 OpenAI Chat Completions API，支持流式与非流式。

POST/v1/messages

创建消息 — 兼容 Claude / Anthropic Messages API，供当前目录中的 Claude 模型使用（Claude Code 路径）。

POST/v1/responses

创建响应 — 兼容 OpenAI Responses API，供当前目录中的 GPT 系列模型使用（Codex CLI 原生路径）。

模型目录

GET/v1/models

列出当前 Key 可调用的模型 ID — Codex CLI 与 Claude Code 每个会话拉取的那份目录，支持 ETag / 304。

图片生成

POST/v1/images/generations

文本生成图片 — 尺寸参数按原值传给模型，返回 URL 或 base64。

POST/v1/images/edits

用文本指令改写参考图（图生图）— multipart 上传图片文件，返回 URL 或 base64。

视频生成

POST/v1/videos/generations

提交视频生成任务 — 异步执行，返回 task_id 供轮询。

GET/v1/videos/generations/{task_id}

查询视频生成状态 — 任务阶段、最终视频 URL 或失败原因。

使用指南

快速开始

5 分钟发出第一个请求——base URL 对照、curl、OpenAI SDK、Anthropic SDK、流式输出。

CLI 配置指南

Claude Code、Codex 一键接入；OpenClaw、Hermes Agent 手动配置步骤。

CC Switch 图形化配置教程

用桌面应用把 Claude Code、Codex 接入 Router One，不用手动配置环境变量。

常见问题与排障

base URL 选择、401/402/429 排查、CLI 配置问题、请求级成本查询。

模型广场

查看模型 ID、价格、上下文窗口和能力标签。

请求日志

按模型和日期筛选，查看请求 ID、HTTP 状态、token、结算与已记录的延迟。

常见错误码

常见错误码
状态码含义处理建议
401API Key 无效或缺失检查 Authorization Header。
402余额不足或 Key 消费上限已达充值或调高该 Key 的 maxSpend——充值不会解除 Key 上限。
429请求频率超限读 Retry-After 退避重试；code 会指明命中的限额（RATE_LIMIT_EXCEEDED、TOKEN_QUOTA_EXCEEDED、SUBSCRIPTION_QUOTA_EXCEEDED）。需要更高限额联系支持。
500服务器内部错误稍后重试，如持续出现请联系支持。