Router One 使用文档

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

开始使用

1
注册账号
打开注册页，创建你的 Router One 账号。
注册
2
创建 API Key
进入 Dashboard -> API Keys，为项目生成独立密钥。
API Keys
3
发送第一个请求
调用 Chat Completions 端点，并在 Header 里带上 Authorization: Bearer <key>。
端点参考

请求示例

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 兼容端点，用来统一处理模型调用、智能路由、自动 fallback、预算控制和每请求观测。

核心价值

用同一个 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 系列模型使用。

POST/v1/responses

创建响应 — 兼容 OpenAI Responses API，供 GPT 系列模型使用。

图片生成

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 或失败原因。

配置指南

CLI 配置指南

配置 Claude Code、Codex CLI、OpenClaw 和 Hermes Agent 通过 Router One 调用模型。

CC Switch 图形化配置教程

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

模型广场

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

常见错误码

常见错误码
状态码	含义	处理建议
`401`	API Key 无效或缺失	检查 Authorization Header。
`402`	余额不足	充值或调整预算。
`429`	请求频率超限	先查看 Dashboard -> Logs，再降低请求频率或联系支持提升限额。
`500`	服务器内部错误	稍后重试，如持续出现请联系支持。