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 密钥，把它作为 Bearer 令牌放在 Authorization 头里。
Router 密钥在管理面的 /v1/router/keys 上创建和吊销。

​
管理面认证

/v1/router/* 下的管理路由支持三种认证方式：
  1. 会话 Cookie：调用 /v1/router/auth/login 登录，响应的 Set-Cookie 里带有 aria_router_session。后续请求带上这个 Cookie。
  2. X-Api-Key 头：把 API 密钥放在 X-Api-Key 头里。
  3. Authorization: Bearer：放一个有效的会话令牌，且不带密钥前缀（密钥以 sk-aria_ 或 sk-bf- 开头；会话令牌是十六进制字符串，会被解析成用户而不是 API 密钥）。
使用会话 Cookie 的示例：
使用 X-Api-Key 的示例：
Router 还没配置本地用户时，管理面是开放的（无需认证），方便你完成初始设置。