系统集成
“系统集成”指你的业务系统如何同时使用代理服务(Proxy,推理)与管理后台的管理接口(开通与运维)。管理后台左侧另有**分析(Analytics)**等菜单,与本文所述接口相互独立,可按需使用。
环境变量(常见)
Section titled “环境变量(常见)”| 变量 | 用途 |
|---|---|
GATEWAY_URL | 代理服务的根地址;应用或 SDK 发推理请求时使用 |
GATEWAY_MASTER_URL | 管理后台的根地址;服务端调用其下的管理 API 时使用 |
GATEWAY_MASTER_KEY | 在 系统集成 → 集成密钥(Integration Keys) 创建的具名 Admin API Key,仅放在服务端;环境变量名可继续沿用 |
推理(应用侧)
Section titled “推理(应用侧)”- 协议与路径以当前网关版本为准,例如 OpenAI 兼容的 Chat 与 Responses 接口;鉴权为
Authorization: Bearer sk-…。 - 可使用
GET /v1/me(向代理服务发起并携带用户密钥)查看预算摘要,便于在自家产品中展示额度(字段以当前版本为准)。
控制面(服务端)
Section titled “控制面(服务端)”典型流程:用户在你的门户注册成功 → 服务端用具名集成密钥调用管理接口创建或更新网关用户 → 创建 API 密钥 → 将 sk-… 仅返回给可信环境或仅保存在服务端。
升级环境会把旧 MASTER_KEY 迁移为全权限的 legacy-master。确认外部系统已经改用具名、最小权限密钥后,应轮换或吊销 legacy-master。
接口索引与约定见 GitHub 技术参考。