dsh-sensenova-freeapi

🚀 快速上手：注册、申请 Key、配置账户

1. 注册 SenseNova 账号

到 https://platform.sensenova.cn/login 注册并登录（支持手机号 / 邮箱）。

2. 在控制台申请多个 API Key

进入控制台 https://platform.sensenova.cn/console，在「API Key 管理」中创建密钥。每个 API Key 对应一次限流额度，多申请几把即可显著提升吞吐。

📷 账户配置界面示意（控制台申请多个 API Key 的位置）：

3. 建议注册 ≥ 2 个账户

SenseNova 的限流额度是账户级 / 端点级的（同一账户内多把 Key 共享同一个额度桶），因此把 API Key 分散到 ≥ 2 个账户才能绕开单账户瓶颈。

• 2 个账户已足够普通用户使用；需要更高吞吐可继续增加。
• 本插件运行态/阻塞态双列表 + 账户轮换就是为「多账户」设计的。

4. 建议 API Key 输入顺序：按账户交替

在 Models 页配置 accounts[] 时，把不同账户的 Key 交替排列，例如有 2 个账户 A、B，则填写顺序为：

A1  B1  A2  B2  A3  B3  …（即 121212 交替）

这样每把 Key 之间天然错位，轮换时不会在同一账户内打转，显著降低单账户触顶概率。

• 可以按需申请更多 Key；开源作者实测使用的是 2 个账户 10 个 API Key（每账户 5 把）达到最优平衡。

5. 推荐模型

以下结论来自垃圾站长程实测校准（2026-09），按首选用途排序：

模型	能力 / 说明	推荐度
deepseek-v4-flash	首选。DeepSeek V4 Flash（0731），任意时段使用都只比 DeepSeek 官方 API 慢一点点；低成本、1M 上下文、支持思考/工具调用	⭐⭐⭐⭐⭐
sensenova-6.8-flash-lite	6.8-flash-lite 走轻量专属额度池，真视觉（读图、截图唯一可靠）、墙钟最快（26.6× 提速）	⭐⭐⭐⭐⭐（读图首选）
kimi-k3	月之暗面旗舰多模态 Agent，原生态视觉 + 1M 上下文，适合长程编程/知识工作	⭐⭐⭐⭐
glm-5.2	智谱长程 Agent，持续吞吐最高（比 deepseek-flash 快 201%、延迟快 45%），但无视觉（读图会幻觉）	⭐⭐⭐⭐（纯文本/长程）
⚠️ deepseek-flash（DeepSeek V4.1 Flash）	不建议：实测高峰期很慢、低峰期也只能达到官网 API 一半速度及以下	❌

💡 一句话结论：日常/代码/Agent 用 deepseek-v4-flash；要读图用 sensenova-6.8-flash-lite；追求极限文本吞吐且不读图用 glm-5.2。不要用 deepseek-flash（V4.1）。

---

双账户轮换：交替使用，降低报错与限流

• 支持 1 个默认账户 + 多个额外账户（accounts[]，各配独立 apiKeyEnv 凭据引用），共享同一 base URL。
• 请求按「账户交替」轮换：被 exclude（401 或配额轮换）的 Key 会从下一位置环回，避免旧实现「前两把反复、第 3+ 把轮不到」的问题。
• 配额类 429 粘性换 Key：被拒的 Key 保持可用状态，下次从下一把继续，把单 Key 瞬时限流摊到多把。
• 401（凭据无效）才永久禁用该 Key，直到再 + 凭据被修改；429 一律不冷却、不禁用（渠道限流属于常态，不代表账号异常）。

---

配置项

字段	类型	默认	含义
apiBase	string	https://token.sensenova.cn/v1	所有账户共享的 base URL
apiKeyEnv	credential-ref	SENSENOVA_API_KEY	默认账户凭据引用
accounts[]	array	[]	额外账户：{ id, label, apiKeyEnv }
activeAccount	string	""	首选账户 id；空 = 自动 / 首个可用
quotaRotation	bool	false	配额类 429 是否粘性换 Key
concurrency	int	1	每 Key 并发闸上限（达限排队 FIFO）
queueTimeoutMs	int	60000	排队等待上限
poolPolicy.kickThreshold	int	2	连续多少次 tpm 限流踢出运行态
poolPolicy.probeInitialMs	int	15000	首次探测间隔
poolPolicy.probeBackoffFactor	int	2	探测失败退避倍率
poolPolicy.probeMaxMs	int	60000	探测间隔上限
poolPolicy.capacity	int	10	池容量上限
errorLog	bool	true	是否记录限流事件到错误日志

API Keys 一律经 DSH 凭据服务存储，永不写入日志、永不发送给模型。

---