3.11 模型网关
模型网关把团队可用的模型统一成一个 OpenAI 兼容的调用入口：业务系统不需要持有任何模型服务商的密钥，用应用接入 key 鉴权，即可像调用 OpenAI 一样调用平台内的模型。额度计入团队，模型可见范围由平台统一管控。
入口在团队空间的「模型网关」菜单：
页面给出两件事：
- 接入地址（Base URL）：
{平台地址}/api/aigateway/{团队ID}/v1，一键复制； - 可用模型清单：模型名称、模型 ID、所属渠道、额度（已用/上限）与累计消耗——业务系统可选用的就是这张表里的模型。
接口与协议
在 Base URL 后拼接协议路径即可调用：
| 路径 | 对应协议 |
|---|---|
/chat/completions | OpenAI Chat Completions |
/responses | OpenAI Responses |
/messages | Anthropic Messages |
鉴权
使用勾选了「模型网关」范围的应用接入 key（moai-ac- 前缀，见 3.10），两种请求头均可：
Authorization: Bearer moai-ac-xxxxxxxx
x-api-key: moai-ac-xxxxxxxx
网关会校验：key 是否有效、是否勾选模型网关范围、请求的模型是否在该团队可见范围内——任一不满足直接拒绝。
从业务系统调用
以 OpenAI SDK 为例，把地址与密钥换成网关的即可：
from openai import OpenAI
client = OpenAI(
base_url="https://你的平台地址/api/aigateway/1/v1",
api_key="moai-ac-xxxxxxxx",
)
resp = client.chat.completions.create(
model="glm-5.3-flash",
messages=[{"role": "user", "content": "用一句话介绍云途网盘"}],
)
print(resp.choices[0].message.content)
模型 ID 使用网关页「模型 ID」列的值。原有的 OpenAI 调用代码只需改 base_url 与 api_key 两个参数，即可无缝迁移。
额度与治理
- 计量：通过网关的每次调用计入团队额度（额度在 3.2 模型 的授权与额度中配置），网关页实时展示每个模型的已用与累计消耗；
- 可观测：哪个模型被谁用、用了多少 token，团队内一目了然；
- 收口：服务商密钥只存在于平台渠道配置中（3.2 模型），业务系统永远接触不到——密钥轮换、渠道切换对业务透明。
案例：三套业务系统统一走网关
企业里报表系统、客服工单、代码评审机器人各自接了大模型，密钥散落、用量不明。统一到网关的步骤：
- 管理员为每个系统创建独立的应用接入 key（只勾「模型网关」），按系统命名；
- 各系统把
base_url指向网关、api_key换成自己的 key； - 此后所有调用在网关页按模型可见消耗，哪个系统用量异常一眼可辨；服务商换渠道（如切换到更便宜的模型服务）只需在 3.2 模型 调整渠道配置，三个系统零改动。
常见问题
返回 401？
key 未勾选「模型网关」范围、key 已失效，或鉴权头格式不对。范围调整实时生效。
返回「模型不存在/无权限」？
请求的模型不在该团队可见范围：到 3.2 模型 确认模型的可见性与启用状态，或改用网关页列出的模型。
流式输出支持吗？
支持。/chat/completions 按标准 stream: true 语义返回 SSE 流。
为什么计入团队额度？
网关调用代表团队在消耗服务商配额，按团队计量才能在 3.2 里给不同模型设周期上限，防止单个集成把配额跑满。