Skip to main content
咏唱引擎 ROUTER 有两套认证面。数据面使用 OpenAI 风格的 Authorization: Bearer <router-key> 头。管理面接受来自登录的会话 Cookie、X-Api-Key 头，或 Authorization: Bearer <session-token> 头。 永远无需认证的公开路由包括 /health、/v1/router/version、/v1/router/auth/register、/v1/router/auth/register-status、/v1/router/auth/login 与 /v1/router/auth/oauth/callback。

​
数据面认证

推理接口（/v1/chat/completions 与 /v1/models）需要 ROUTER API 密钥。在 Authorization 头中以 Bearer 令牌的形式携带它。
可通过管理面在 /v1/router/keys 创建与吊销 Router 密钥。

​
管理面认证

/v1/router/* 下的管理路由支持三种认证方式：
  1. 会话 Cookie：通过 /v1/router/auth/login 登录，收到包含 aria_router_session 的 Set-Cookie 响应。在后续请求中携带该 Cookie。
  2. X-Api-Key 头：在 X-Api-Key 头中携带你的 API 密钥。
  3. Authorization: Bearer：携带带非密钥前缀的有效会话令牌（密钥以 sk-aria_ 或 sk-bf- 开头；会话令牌为十六进制字符串，会被解析为用户而非 API 密钥）。
使用会话 Cookie 的示例：
使用 X-Api-Key 的示例：
如果 Router 尚未配置本地用户，管理面是开放的（无需认证），以便你执行初始设置。