Skip to content

在 magpie 中使用 ​

magpie 是一个本地 AI 网关:把你的各个 AI 账号(订阅、API 令牌、钱包)汇在一起,再按你设定的路由方式分给 Claude Code、Codex 等工具使用。绝命毒师提供官方插件 magpie-jmds,装上后 magpie 能直接看到你令牌的订阅用量、额外用量、钱包余额和模型价格,并据此调度。

插件只把这些事实报给 magpie,不替你做调度决定——用哪种路由方式、账号先后顺序,都由你在 magpie 里自己配置。

准备工作 ​

1. 安装 magpie(需要 v0.1.1937 及以上),见 magpie 官网。

2. 创建令牌:登录 jmds.dev 控制台,进入 令牌 / API Keys 创建,复制 sk- 开头的完整密钥。详见 创建 API 令牌。

订阅令牌和按量令牌

令牌隶属于某个分组(详见 认识分组)。绑定订阅分组的令牌消耗订阅额度,绑定按量分组的令牌扣钱包余额。两种都有的话,各建一枚、分别登录,magpie 就能同时看到并按你的路由方式使用。

安装插件并登录 ​

bash
magpie plugin add magpie-jmds
magpie plugin login jmds

也可以在 magpie 应用的 插件 页搜索安装 magpie-jmds,再添加 jmds 账号。

登录时插件会先问一个可选的账号名(如 订阅、按量,直接回车则显示为 api.jmds.dev …令牌后四位),然后粘贴 sk- 令牌即可。不需要填写站点地址,也不需要网页登录密码。有多枚令牌时重复执行 magpie plugin login jmds。

登录后模型名为 jmds/<模型ID>,例如 jmds/gpt-5.5。

magpie 里会看到什么 ​

令牌类型显示内容
订阅令牌套餐名、到期时间,以及 24 hours / 7 days / 30 days 用量窗口(已用 / 上限、重置时间);没有设置上限的窗口不显示
额外用量(加油包)额外用量 已用 / 累计发放。订阅窗口用满但加油包还有余额时,用满的窗口只展示、不再拦住这枚令牌,改由加油包参与可用量判断
按量令牌套餐 按量付费 和 余额 钱包,显示美元余额;余额为零时 magpie 会把它视为已用尽
令牌自身限额若你给令牌设置了总额度或 5 小时 / 每日 / 7 天限额,会显示 Key 总额度 等窗口,和订阅窗口同时显示
模型价格每个模型的输入 / 输出 / 缓存读写单价(美元 / 百万 token),已按你分组的倍率换算;按次计费的模型不显示单价

路由怎么配 ​

在 magpie 里按自己的需要选择路由方式,常见用法:

  • 先用订阅、用完再扣余额:订阅令牌和按量令牌都登录后,使用「按用量最少」(订阅还有额度时会排在钱包前面),或「按顺序」并把订阅令牌排在前面。
  • 和其他服务商比价:把 jmds 与其他服务商放进同一个路由组,选择「最便宜」,magpie 会按插件报的模型单价挑选。
  • 多枚订阅令牌轮流用:使用默认的智能路由,magpie 会根据各窗口的用量和重置时间分配。

常见问题 ​

登录后提示无订阅 / 订阅已过期? 这枚令牌绑定的是订阅分组,但当前账户在该分组下没有有效订阅。续费后即恢复,或改用按量分组的令牌。

提示需要重新登录? 令牌已过期或被删除。到控制台 令牌页面 新建一枚,再执行 magpie plugin login jmds 登录。

用量满了之后 magpie 还会继续用这枚令牌吗? 插件会把站点的拒绝原因整理成 magpie 能识别的形式:订阅额度用尽时,magpie 会让这枚令牌休息到窗口重置;余额不足时按余额耗尽处理;短时限流只短暂避让。

会不会额外扣费? 读取用量和价格不消耗额度;只有 magpie 实际转发的模型请求会按正常价格计费。

插件源码与问题反馈:jmds-api/magpie-jmds。更多排查请见 常见问题。