部署与运营

供应商接入

配置上游模型与安全的服务端密钥。

配置模型映射

在控制台添加供应商名称、HTTPS Base URL、上游模型 ID、对外模型 ID 和密钥变量名。一条配置对应一个模型路由；同一工作空间的模型 ID 不能重复。

名称：我的模型服务
Base URL：https://api.your-provider.com/v1
对外模型 ID：my-chat-model
上游模型 ID：供应商模型标识
密钥变量：UPSTREAM_PRIMARY_KEY

真实 API Key 仅在部署环境设置。启用路由还需要人工配置完全匹配的域名白名单，并开启真实调用开关，并把工作空间身份 ID 加入 LIVE_ALLOWED_USER_IDS。

GATEWAY_ENABLE_LIVE=true
LIVE_ALLOWED_USER_IDS=<平台设置里的身份标识>
UPSTREAM_ALLOWED_HOSTS=api.your-provider.com
UPSTREAM_PRIMARY_KEY=<通过部署平台的密钥管理设置>

不要把真实密钥填进供应商表单。禁止 HTTP、IP 地址、非标准端口和自动跟随重定向。白名单只允许你审核过的供应商域名，生产部署还应限制出口到私有网络。

依次验证非流式文本请求、流式结束事件、模型映射、上游 usage、超时、429、断连与取消。当前未做真实供应商验证，也没有自动故障切换。不同供应商的参数和流式计量支持需要逐项适配。