跳转到内容

系统集成

“系统集成”指你的业务系统如何同时使用代理服务(Proxy,推理)管理后台的管理接口(开通与运维)。管理后台左侧另有**分析(Analytics)**等菜单,与本文所述接口相互独立,可按需使用。

变量用途
GATEWAY_URL代理服务的根地址;应用或 SDK 发推理请求时使用
GATEWAY_MASTER_URL管理后台的根地址;服务端调用其下的管理 API 时使用
GATEWAY_MASTER_KEY系统集成 → 集成密钥(Integration Keys) 创建的具名 Admin API Key,仅放在服务端;环境变量名可继续沿用
  • 协议与路径以当前网关版本为准,例如 OpenAI 兼容的 Chat 与 Responses 接口;鉴权为 Authorization: Bearer sk-…
  • 可使用 GET /v1/me(向代理服务发起并携带用户密钥)查看预算摘要,便于在自家产品中展示额度(字段以当前版本为准)。

典型流程:用户在你的门户注册成功 → 服务端用具名集成密钥调用管理接口创建或更新网关用户创建 API 密钥 → 将 sk-… 仅返回给可信环境或仅保存在服务端。

升级环境会把旧 MASTER_KEY 迁移为全权限的 legacy-master。确认外部系统已经改用具名、最小权限密钥后,应轮换或吊销 legacy-master

接口索引与约定见 GitHub 技术参考