> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ariacompute.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# 咏唱引擎 ROUTER：OpenAI 兼容推理网关

> 咏唱引擎 ROUTER 是一个自托管的推理网关，支持两种路由模式：语义路由（YAML v0.3 配方）与智能体路由（内建工具循环）。探索数据面与管理面接口。

咏唱引擎 ROUTER 是一个自托管的 OpenAI 兼容推理网关。它提供两套并列的路由引擎：一套**语义路由器**，依据 YAML v0.3 配方使用路由信号匹配请求；以及一套**智能体路由器**，运行进程内内建工具循环。Router 为推理客户端暴露数据面，为运维人员暴露管理面。

数据面实现了标准的 OpenAI `/v1/models` 与 `/v1/chat/completions` 接口，因此现有 SDK 无需改动即可使用。管理面覆盖认证、路由配置、成本追踪与密钥管理，位于 `/v1/router/*` 之下。

共享的 provider 模型与硬约束（成本、延迟、能力）在请求时进行求值。你可以在一份 YAML v0.3 配置文件中配置入口、provider 与路由规则，Router 会动态重新加载。

<CardGroup cols={2}>
  <Card title="认证" icon="lock" href="/api-reference/router/authentication">
    如何向 Router 认证：数据面使用 Bearer 令牌，管理面使用会话或 API 密钥。
  </Card>

  <Card title="Chat Completions" icon="message" href="/api-reference/router/openai/chat-completions">
    通过 Router 发送聊天请求，支持标准 OpenAI 参数与流式输出。
  </Card>

  <Card title="列出模型" icon="list" href="/api-reference/router/openai/list-models">
    通过 OpenAI 兼容的模型接口发现可用的入口与 provider 模型。
  </Card>

  <Card title="认证接口" icon="user" href="/api-reference/router/auth/login">
    注册、登录、管理用户，并为 Router 控制台配置 OAuth。
  </Card>
</CardGroup>

## 基础 URL

```text theme={null}
http://<router-host>:8080
```

Router 是自托管的。请将 `<router-host>` 替换为你的 Router 实例运行所在的主机。