Metapi下游API Key完整指南：按项目、按成员发独立密钥，用量管控一步到位-平芜编程栈

Metapi下游API Key完整指南：按项目、按成员发独立密钥，用量管控一步到位

【免费下载链接】metapi把你在各处注册的 New API / One API / OneHub / DoneHub / Veloera / AnyRouter / Sub2API 等站点，汇聚成一个 API Key、一个入口，自动发现模型、智能路由、成本最优项目地址: https://gitcode.com/cita-777/metapi

Metapi 下游 API Key是 Metapi 为多项目、多成员共享场景提供的项目级密钥方案：把 New API、One API、OneHub、Veloera 等站点汇聚成统一入口后，你不再需要把同一个全局令牌分发给所有人，而是可以为每个项目、每位成员签发一把独立的下游 API Key，并单独控制它的费用上限、请求次数、模型白名单和有效期。本文用一张图级别的篇幅讲清楚：什么时候需要它、如何一键创建、以及如何做到用量可查、随时停发。

为什么需要下游 API Key，而不是一直用全局令牌？

Metapi 启动时会提供一个全局访问令牌PROXY_TOKEN，所有客户端拿它就能调用。但它只适合个人自用：

对比项	全局`PROXY_TOKEN`	项目级下游 API Key
粒度	一把钥匙开所有门	按项目/成员独立签发
费用与请求上限	不支持	每个 Key 单独设置
模型 / 路由白名单	全部可见	可限制只能调用指定模型、指定路由
过期与回收	换钥影响所有人	单个 Key 禁用/删除，互不干扰
用量归属	混在一起	按 Key 统计花费与请求数

典型适用场景：

🧑‍💻多成员共用一台网关：给每位同事一把独立 Key，谁超支一目了然
📦多项目隔离：A 项目只准用便宜的轻量模型，B 项目才能用旗舰模型
🧾成本核算：按 Key 维度对账，月底直接导出各自花费
🔐安全止损：某把 Key 泄露，禁用它即可，其他 Key 照常工作

一键创建下游 API Key：最快配置方法

入口只有一个：控制台 → 下游密钥（设置页中也提供同样的管理面板）。

点击「新建 API Key」后，按需填写以下字段即可：

字段	作用	建议
Key 名称 / 分组 / 标签	标识归属的项目与成员	用「项目-人名」命名，方便批量筛选
过期时间	到期自动失效	临时密钥务必设置
费用上限	花满即停	按预算给每人设一个
请求上限	次数封顶	防止脚本死循环刷量
模型白名单	限定可调用的模型	成员项目只放开轻量模型
路由白名单	限定走哪条上游路由	隔离不同站点通道
站点权重倍率	调整该 Key 的站点选择倾向	让某项目优先走更稳的站点

保存后系统会生成一把新的 Key，复制给对应用户即可。之后可以随时编辑、禁用、重置用量、删除，列表页支持按状态、名称、标签批量筛选与批量操作，成员多了也不乱。

相关源码：列表页 DownstreamKeys.tsx、编辑弹窗 DownstreamKeyEditorModal.tsx、核心服务 downstreamApiKeyService.ts。

用量管控与监控：花到哪一笔都看得见

发出去的 Key 不是"发完就完事"。Metapi 在「使用日志」中按每一次请求记录：调用的模型、走的站点与账号、输入/输出 token 数、实际花费与重试次数，并支持按下游 Key 维度过滤。

管理动作也很直接：

查看趋势：每个 Key 有独立的用量趋势与统计，谁在烧钱一眼可知
重置用量：按月计费的项目，月初点一下「重置用量」即可清零重新计
一键停用：成员离职或项目下线，禁用对应 Key，客户端立刻 401
日志映射：结合代理日志映射能力，可以精确对到具体站点账号，排查"这笔钱花在哪个上游"

客户端如何接入项目级 Key？

下游 Key 的用法和全局令牌完全一致——客户端只改两样东西：Base URL和API Key。

客户端字段	填法
有 "Base URL" 字段	填`https://your-domain.com`
要求完整 OpenAI 路径	填`https://your-domain.com/v1`
Anthropic 格式客户端	填`https://your-domain.com`，Metapi 自动处理`/v1/messages`

不确定是否连通？先用该 Key 请求/v1/models，能列出模型即可放心配置。完整接入说明见客户端接入文档。