Router One API
OpenAI 兼容的统一模型调用接口。通过智能路由、自动 fallback 和成本优化,让企业安全、可控、低成本地在生产环境运行 AI Agent。
直接调 LLM = 黑盒;通过 Router One 调 LLM = 有账本、有轨迹、有管控。
快速开始
1
获取 API Key
登录 Router One 控制台创建项目并生成 API Key(格式 sk-xxx)。
2
发送请求
使用 OpenAI 兼容格式,将 model 设为 auto 启用智能路由。
3
处理响应
接收标准 Chat Completion 响应,含 token 用量统计。
发送第一个请求
bash
curl https://gateway-xss7.onrender.com/v1/chat/completions \
-H "Authorization: Bearer sk-your-api-key" \
-H "Content-Type: application/json" \
-d '{
"model": "auto",
"messages": [{"role": "user", "content": "你好"}]
}'将 model 设为 auto,Router One 会根据路由策略自动选择最佳模型。也可以指定具体模型如 gpt-4o、claude-sonnet-4-20250514 等。
核心信息
认证方式
Bearer Token
Authorization: Bearer sk-xxx
基础 URL
gateway-xss7.onrender.com
完全兼容 OpenAI API 格式
请求格式
JSON / SSE
支持流式和非流式两种模式
错误码参考
| 状态码 | 说明 | 处理建议 |
|---|---|---|
401 | API Key 无效或缺失 | 检查 Authorization Header |
402 | 余额不足 | 在控制台充值或调整预算 |
429 | 请求频率超限 | 降低请求频率或提升 QPS 限额 |
500 | 服务器内部错误 | 稍后重试,如持续出现请联系支持 |