什么是 LLM 网关?通俗解释
LLM 网关是你的应用与一个或多个语言模型 API 之间的单一入口点。本页解释它处理的内容、何时值得添加,以及该服务在架构中的位置。
更新于

要点
验证接口是否严格遵循 OpenAI chat completions 模式,以实现即插即用兼容性。
确保上下文窗口大小符合应用的内存需求,以避免截断错误。
实现流式输出支持,以处理长生成延迟并改善用户体验。
确认隐私政策与您的数据保留需求一致,特别是关于提示词存储的部分。
简短定义
什么是 LLM 网关?它是位于您的应用与语言模型 API 之间的服务或代码。您的应用将每个请求发送到一个地址,网关决定如何处理它:检查请求者身份、选择模型或提供商、执行速率限制、转发调用、记录情况并返回答案。应用只与一个接口通信,并不关心其后端具体是什么。
这一概念借鉴了 Web 服务中多年来使用的 API 网关。不同之处在于,流量是模型调用,它们速度较慢、按 token 计费且通常进行流式输出,因此语言模型网关需要完成普通网关不具备的一些任务。
大多数网关暴露与 OpenAI SDK 相同的请求格式。这一选择很实用。几乎所有客户端库、框架和工具都支持该格式,因此只需更改一个基础 URL 即可将网关置于现有应用之前。
网关的功能
不同产品提供不同功能,但常见功能集如下。
| 功能 | 实际意义 |
|---|---|
| 密钥 | 提供商密钥集中存储。应用和团队成员获得独立密钥,你可撤销密钥而无需接触提供商。 |
| 路由 | 请求按规则发送至选定模型或提供商:按任务、用户或成本。 |
| 回退 | 如果一个后端故障或缓慢,请求将发送至另一个后端。 |
| 速率限制 | 按用户或应用的上限可防止单个客户端耗尽共享容量。 |
| 重试与超时 | HTTP 429 等临时错误在一个位置重试,而非在每个服务中重试。 |
| 日志与成本追踪 | 每个请求都记录 token、延迟和费用,以便查看谁花费多少。 |
| 缓存 | 相同请求可返回存储的答案,避免重复计费。 |
| 护栏 | 输入输出检查,例如在数据离开网络前移除个人数据。 |
并非每个项目都需要所有功能。网关的价值随应用、团队和提供商数量增加而增长。对于单个脚本和一个提供商,它仅增加一个组件和少许复杂性。
何时需要,何时不需要
一个有用的测试是计算你已有的痛点。当对以下两个或三个问题能回答“是”时,网关就能收回成本。
- 多个应用或团队成员共享同一提供商账户,且无法区分谁花费多少?
- 在多个代码库中硬编码了提供商密钥?
- 希望在不重新部署每个服务的情况下切换模型?
- 需要后端返回错误时自动回退?
- 需要保留提示词和答案的审计日志?
如果答案都是“否”,则跳过该步骤。单个机器人或内部工具只需要基础 URL、密钥、超时时间和重试机制。你总是可以在稍后添加网关,由于请求格式相同,改动很小。早期添加网关主要增加额外的运行和调试负担。
成本体现
网关本身可能成为成本中心。自托管代理需要服务器、更新和监控。托管产品通常收取费用或 token 差价;查看你考虑的产品当前定价。在决定前,将其与缓存、路由至更便宜模型和减少故障带来的节省进行对比。
获取网关的三种方式
自行编写轻量层
对于小团队来说,这通常已经足够。一个添加超时、重试 429 和 5xx 响应、记录响应中的 token 使用情况并从配置文件选择模型的包装函数大约只有五十行代码。你保持完全控制且无需额外服务。代价是你需要维护它,且每个新需求都变成你的代码。
运行开源代理
几个开源项目提供了带有密钥、预算和路由功能的 OpenAI 兼容代理。你托管它,因此提示词留在你的基础设施内。你还需要承担升级、安全补丁和可用性维护。请查看每个项目的文档以了解其支持的功能。
使用托管网关
托管产品提供仪表板和日志,无需运行服务器。作为交换,你通过第三方发送流量并接受其定价,因此在发送敏感提示词前阅读其数据策略。
本服务的定位
Open LLM Gateway 不是跨供应商的路由器。它是面向单一开放权重模型的托管 OpenAI 兼容 API,由独立提供商运营,并针对合法成人用途下的无内容审查回答进行了优化。它不是任何模型供应商的官方 API。模型 ID 为 uncensored,该接口接受 POST /v1/chat/completions 和 GET /v1/models。
这使其成为自有网关的干净后端。如果网关持有上游提供商列表,你可将其作为 OpenAI 兼容上游添加,使用下方的基础 URL,并将需要无拒绝模型的请求发送至此处。如果没有网关,你可以直接从应用调用它。两种情况下设置相同。
from openai import OpenAI
client = OpenAI(
base_url="https://api.openllmgateway.com/v1",
api_key="YOUR_KEY",
)
resp = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Explain what a gateway does in two sentences."}],
)
print(resp.choices[0].message.content)
它支持 SSE 流式输出、工具调用、JSON 模式和常用采样参数。仅支持文本:无图像、音频、嵌入或微调。提示词不用于训练。
网关位于其后时的规划要点
由于限制是固定数字,前置网关可从开始就遵守这些限制。完整密钥允许 8 个并发请求和每分钟 300 次请求。试用密钥允许 2 个和 60 次。超过限制时,API 返回 HTTP 429 及代码 rate_limited 或 concurrency,临时过载附带 Retry-After: 5 标头。将网关的每上游并发设置为 8 或更低,并遵循 Retry-After。
响应携带 X-Request-Id 和 X-Balance-USD。记录前者用于调试,监控后者以在余额耗尽前发出警报。流式请求在流结束前会占用其槽位,因此如果网关缓冲了流或未完全读取流,将浪费容量。
上下文窗口为 100,000 个 token(提示词加补全),最大请求体为 8 MB。如果网关添加了系统提示词或注入了历史记录,也要计入这些 token。
定价方面,输入 token 为每 100 万 $0.15,输出 token 为每 100 万 $0.50,从预付额度中扣除,无订阅费用。记录 token 使用量的网关让计算变得简单。一天使用 300 万输入 token 和 500,000 输出 token 的成本为 $0.45 + $0.25 = $0.70。充值金额从 $20 到 $500 不等,充值 $50 起赠 5%,充值 $100 起赠 10%,充值 $200 起赠 15%,支持银行卡或加密货币支付。详情见 定价页面,失败或被拒的请求不收费。
后续步骤
如果你正在考虑是否在技术栈中加入网关,请阅读 AI 网关生产环境检查清单,以在上线前核实要点。要测试接口本身,快速入门 提供了三行客户端更改方法,获取密钥 只需一分钟:使用 Google 或电子邮件和密码注册,然后一键领取 $0.50 试用额度。试用额度有效期为 7 天,无需绑定银行卡,每人限领一次。
如果项目规模较小,可以暂不加入网关。当出现第二个应用、第二个提供商或第一次审计请求时再添加,并保持接口一致,这样迁移成本几乎为零。
更多指南
问答
只差一张表单,即可获得密钥
创建账户,复制密钥,更改基础 URL。这就是全部设置。
LLM 网关与 API 网关是同一个概念吗?
这是相关的概念。LLM 网关专为模型流量设计,因此可以追踪 token、处理流式输出,并能在不同模型或提供商之间进行路由。
Open LLM Gateway 是跨多个模型供应商的路由器吗?
不是。它是一个由独立提供商托管的、针对单一开放权重模型(模型 ID 为 uncensored)的 OpenAI 兼容 API。它可以作为你自有网关后端的单一上游服务。
小型项目需要网关吗?
通常不需要。在多个应用、团队成员或提供商共享设置之前,只需基础 URL、密钥、超时设置和重试循环即可。
网关使用哪种请求格式?
大多数网关使用 OpenAI chat completions 格式,因此更改基础 URL 和密钥后,现有的 SDK 即可使用。本 API 也使用相同的格式。
网关应为本 API 遵守哪些限制?
完整密钥允许 8 个并发请求和每分钟 300 个请求,试用密钥允许 2 个并发请求和每分钟 60 个请求。请遵循 429 响应中的 Retry-After 标头。