zhaoyu-sensenova-duokey

zhaoyu-sensenova-duokey · 商汤多Key轮询

把多个商汤（SenseNova）账号的 API Key 变成一个统一的 OpenAI 兼容端点。 一个 Key 被限流自动换下一个，全部限流就安静等待——不再频繁报 429/503。

作者：zhaoyu · GitHub

为什么需要它

商汤的 API 限流是按账号/Key 计算的。只挂一个 Key 时：

• 聊几轮深度思考就撞限流（tpm exhausted / EndpointTPMExceeded）
• 高峰期频繁 429，客户端一直重试、对话一直中断
• 智能体（Agent）多轮工具调用更是雪上加霜

多挂几个账号的 Key，让代理帮你轮询，就能把额度叠起来用，而且单个 Key 撞墙时不影响整体。

两个包

快速开始

方式一：让 AI 帮你装（推荐，DSH 用户）

把这两句话发给你的 DSH：

帮我安装 zhaoyu-sensenova-duokey 技能，仓库地址： https://github.com/SUJIElearning/zhaoyu-sensenova-duokey

AI 会读取仓库里的 SKILL.md，自动完成：下载脚本 → 问你收集 Key → 写好配置 → 启动 → 验证。

方式二：手动装

# 1. 下载
git clone https://github.com/SUJIElearning/zhaoyu-sensenova-duokey.git
cd zhaoyu-sensenova-duokey/proxy

# 2. 配 Key（Windows 用 start-proxy.bat 里的 set 行；macOS/Linux 用环境变量）
set SENSENOVA_API_KEY_1=sk-你的第一个Key
set SENSENOVA_API_KEY_2=sk-你的第二个Key

# 3. 启动
node sensenova-multikey-proxy.js

看到这行就成功了：

 监听地址:  http://127.0.0.1:15722
 已加载:    2 个账户 Key

方式三：DSH 一键装观察窗口

dsh plugin add @sujielearning/dsh-sensenova-key-status

装完对话框下方会多一行 ● 5/6 Key，绿=全好、黄=部分限流、红=全部耗尽。

客户端怎么接

把任何 OpenAI 兼容客户端的 Base URL 改成：

http://127.0.0.1:15722/v1

API Key 填任意一个真实的商汤 Key 即可（代理会自己轮换）。

模型名用商汤的：deepseek-flash、deepseek-v4-flash、glm-5.2、kimi-k3 等。

遇到「未知发布者」弹窗？

从 GitHub 下载的文件，Windows 会打上「来自互联网」标记，双击 .bat 就会弹 「无法验证发布者，你确定要运行此软件吗？」。这不是病毒警告，是下载标记。

一条命令解决：

Get-ChildItem "<你的安装目录>" -Recurse -File | Unblock-File

或者双击 proxy\unblock-files.bat。跑一次，以后不再弹。

开机自启（推荐）

代理是个普通进程，电脑重启后就没了。双击一次装好自启：

proxy\install-autostart.bat

取消：proxy\uninstall-autostart.bat ｜ 临时停止：proxy\stop-proxy.bat

常用操作

# 看健康状态
curl http://127.0.0.1:15722/health

# 看每个 Key 的详细状态（可用/冷却中/累计错误）
curl http://127.0.0.1:15722/status

# 加 Key：往配置里追加一行，然后重启代理

它做了什么（工作原理）

你的客户端 ──→ 本地代理(15722) ──→ 商汤 API
                    │
                    ├─ 按"最近消耗最少"选 Key
                    ├─ 撞 429 → 该 Key 冷却 45-120 秒
                    ├─ 其余 Key 顶上，最多试 12 次
                    └─ 全部不可用 → 等最多 100 秒再放弃

• 不是魔法：它不能突破商汤给你的物理额度上限，只是把多个账号的额度叠起来用，并且避免"白白撞墙"
• 零依赖：只用 Node.js 内置模块，不需要 npm install
• 不存数据：只在本机转发，Key 只存在你本地的配置文件里

限度说明（诚实版）

• 它救不了"额度真的不够"：如果 6 个账号都耗尽，还是得等或加账号
• 长对话特别吃额度：商汤把 prompt token 也算进限流，几十轮对话单次请求就可能几万 token
• 单 Key 撞墙后恢复要几分钟（实测 8-10 分钟全组恢复），代理能做的是"不等死、换人上"

许可

MIT — 随便用、随便改、商用也行，出事别找我。

---

_{by zhaoyu · zhaoyu-sensenova-duokey}