璇玑网关是一个 AI 接口中转站。你把各个 AI 厂商的 API(比如 DeepSeek、商汤、硅基流动)接进来,它帮你统一管理、自动切换、按最省钱的方式路由,然后给你一个统一的接口地址。
别人(或你自己的程序)只需要记住这一个地址,不用管后面接了几家 AI。
下面跟着做,10 分钟就能配好。
打开管理页面,点导航栏的「上游管理」,看到所有已接入的 AI 厂商列表(这叫”上游”)。

点右上角的 「+ 添加上游」:

只需要填 4 项:
我的DeepSeek,方便认就行https://xxx.com/v1 这种,厂商文档里有其他字段先不用管(尤其是模型列表,很多厂商有几十上百个模型,不用手动填)。
点「确定」保存。
在上游列表里找到刚加的厂商,点它的 「编辑」:

点 「从上游获取模型」 按钮,网关会自动向这个厂商要一份完整的模型清单,并自动生成”简单名 → 真实名”的映射:

看到模型列表和映射自动填好了,点「确定」保存。
为什么要自动获取?因为有些厂商有几十上百个模型,手动填容易错,自动拉取最准。
模型映射的值可以用竖线 | 写多个真实模型名,比如把 deepseek-v4-flash 映射成:
{"deepseek-v4-flash":"deepseek-v4.1-flash|deepseek-v4-flash"}
语义是按书写顺序优先:每次请求先用第一个(deepseek-v4.1-flash);它因配额/额度用尽被拒(429)时,网关会在同一厂商内自动换第二个,而不是换厂商。被用尽的模型会冷却一段时间,后续请求直接走第二个;冷却到期后自动回第一个重试。
这是全局默认行为,对所有厂商、所有模型通用,无需额外开关。
注意:只有配额类 429(响应里带 quota / 上限 / 套餐用尽等字样)才触发降级;单纯的并发限流(稍后重试即可)不会踢掉模型。
点导航栏的「路由规则」,点 「+ 添加规则」:

弹窗里配 3 样东西:

auto
auto 映射成上游的 deepseek-v4-flash)deepseek-* 就能匹配所有 deepseek 开头的模型
点「确定」保存,路由规则就配好了。
点导航栏的「API Key」,点 「+ 创建 Key」:


填一个名称(用途,比如”我的程序”、”同事小张”),Key 留空会自动生成。
创建后拿到一个 sk- 开头的密钥,这就是访问网关的钥匙。
把你的 AI 工具或程序指向:
http://你的服务器IP:3001/v1
请求头带上:
Authorization: Bearer sk-你的密钥
模型名填你第二步起的名字(比如 auto),其他用法和官方 OpenAI 接口一模一样。
点导航栏的「系统设置」:

alert.webhook_url 改成你的 Webhook 地址
(企业微信/钉钉/飞书机器人、自建通知服务均可,POST JSON)。填好后,某个上游连续探测失败
达到 alert.consecutive_fails 次(默认 3)转为「降级/不可用」时会推送告警,恢复正常时也会推一条;
同一上游 10 分钟内同类告警只发一次,不会刷屏。留空即关闭。「请求统计」页的每上游表格,点击任意一行可展开该上游各真实模型的明细:
Tokens/秒 = 该模型输出 token(含思考)÷ 累计耗时,与上游级的口径一致,可直接对比。
Q:请求地址是 IP:端口,不能用绑定的域名吗?
可以。网关本身不绑定域名,任何能访问到你服务器的域名都能用(域名解析到这台机器,或用 Nginx/Caddy 反代 3001 端口即可)。把 http://你的服务器IP:3001/v1 换成 https://你的域名/v1 就行。
Q:后台复制的 Key,还需要加前缀吗?
不用。Bearer 是 HTTP 认证协议的关键字,不是 Key 的一部分。
api_key 参数,SDK 自动处理Authorization: Bearer sk-你的key1) 上游管理:添加上游(名称/BaseURL/APIKey/层级)→ 编辑 → 从上游获取模型
2) 路由规则:添加规则(起名 → 勾上游 → 选多模态/兜底)
3) API Key:创建 Key → 把 Key 发给使用者 → 指向 ip:port/v1
配好这三步,别人就能用你给的 Key 调 AI 了。其他功能(对话调试、请求日志、统计)都是辅助,后面慢慢玩。