向咏唱引擎 ROUTER 认证

了解如何向咏唱引擎 ROUTER 的数据面与管理面认证。推理使用 Bearer API 密钥，管理路由使用会话 Cookie 或 X-Api-Key。

咏唱引擎 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 令牌的形式携带它。

curl -H 'Authorization: Bearer sk-aria_...' \
  http://<router-host>:8080/v1/chat/completions

可通过管理面在 /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 的示例：

curl -b cookies.txt http://<router-host>:8080/v1/router/auth/me

使用 X-Api-Key 的示例：

curl -H 'X-Api-Key: $ARIA_ROUTER_KEY' http://<router-host>:8080/v1/router/keys

如果 Router 尚未配置本地用户，管理面是开放的（无需认证），以便你执行初始设置。