treg 密钥优先（own-key always wins）规则详解：4 种方式降低 API 调用成本（完整指南）
【免费下载链接】tregOpenRouter for agent tools. Join community here: https://discord.gg/6mQYYfFMAn项目地址: https://gitcode.com/GitHub_Trending/treg/treg
treg 是一个"面向 Agent 工具的 OpenRouter"——用一枚 API 密钥即可调用 60+ 供应商的 3000+ 工具端点，按次计费、低至美分。它最重要的省钱规则就是own-key always wins（自带密钥永远优先）：只要你把自己的 API Key 接入团队，所有相关调用都会走你自己的密钥，完全不消耗 treg 的预付余额。本文将这条"凭证阶梯"讲得明明白白，并给出新手即刻可用的 4 种实操省钱方式，让每一分钱都花在正确的账本上。
一分钟了解 treg：为工具而生的统一密钥层
treg 解决的是一个很具体的痛点：Agent 干活需要的外部数据工具（SEO、背链、公司情报、广告库、抓取、图视频生成）通常藏在月费订阅后面——Semrush $139/月、Moz $99/月、Crunchbase $99/月——还要各自注册账号。treg 把这些账号"拿过来"，把能力拆成按次计费的端点：搜到想做的事、看清价格、直接调用，无需在供应商处开户。
它提供两类工具，共用一个团队令牌：
| 类型 | 凭证来源 | 是否消耗 treg 余额 |
|---|---|---|
| 目录工具（catalog） | treg 平台密钥 / 免密钥公开路由 | 可能（见下文阶梯） |
| 你自己的工具（own tool） | 团队自己注册的密钥、OAuth 或 CLI | 永不 |
凭证阶梯：4 个层级决定一次调用怎么扣费
当你对某个目录端点发起调用时，treg 会按固定的优先级（credential ladder）选择用谁的凭证。这个逻辑实现在 src/treg/application/call/resolve.py，顺序是：
- 团队注册了自己的工具（绑定了对应供应商的密钥）→ 用你的工具、你的密钥，不计量；
- 团队为该供应商存了密钥（secret）→ 通过虚拟工具注入你的密钥，不计量；
- 以上都没有，且该端点有已验证的免密钥公开路由→ 直接免费调用；
- 以上都没有 → 用treg 自己的平台密钥，按预估价格从团队预付余额中扣除。
前两层就是 "own-key always wins" 的字面含义：你的凭证永远排在 treg 的凭证前面，且永远不被计量。
为什么自带密钥能省钱：4 重收益
- 不重复付费。官方 README 的原话是：接入一个你已经在付钱的密钥，让那些调用"free of the balance rather than duplicating them"——你已为订阅付费，就不该再让 treg 余额为同样的数据付一次钱。
- 零平台加成。走平台密钥的调用在预留和结算两个环节都会应用 margin（加成费率），而 own-key 调用根本不进入资金路径：没有预留（hold）、没有账本（ledger）记录、没有加成。
- 不被余额和上限卡住。平台调用余额不足会收到 HTTP 402，还可能触发每团队每日消费上限（fail-closed 直接拒绝）；own-key 调用不经过这些闸门，不会 402，不受日上限约束。
- 突破免费配额。treg 对部分供应商用"每日每团队 N 次"的免费试用池提供服务，用尽即止；换成自带密钥就是无限量。
一句话：平台密钥适合"先尝后买"，自带密钥才是长期成本最低的路径。
快速上手：3 种方式接入你自己的 API Key
方式一：一条命令保存单个密钥
在 CLI 中两步完成——先存密钥，再绑定工具（完整命令参考 USAGE.md）：
treg secret add semrush-key --value "$SEMANTIC_KEY" # 密钥服务器端 Fernet 加密存储 treg add semrush --base-url <供应商地址> --secret semrush-key也可以在控制台的 Secrets 面板里粘贴密钥、在 Add tool 弹窗中配置凭证注入（header、query 还是 JSON 字段），效果完全一致：
方式二：从 .env 批量接入全部密钥
项目里已经堆了一堆供应商密钥？treg upload会扫描.env并匹配约 80 个已知供应商，一次注册：
treg scan # 只读预览：将注册哪些密钥/技能/CLI treg upload env --select openai,stripe,semrush方式三：OAuth 一键连接，免去应用审批
Google Search Console、Meta Ads、X、LinkedIn 这类"审批成本高"的平台，treg 已持审批过的应用，浏览器授权即可，treg 保管令牌并自动刷新：
treg oauth connect gsc --client-secret client_secret.json \ --scopes https://www.googleapis.com/auth/webmasters.readonly连接后用treg health检查凭证健康状态。所有密钥只存不用本地持有：值服务器端加密、接口永不回显，队友的 Agent 可以调用你的工具而密钥从未离开服务器（安全细节见 docs/context/architecture/auth-secrets.md）。
幕后计费：平台密钥调用如何收费
理解钱怎么花，才知道钱省在哪。平台密钥（第 4 层）的调用走"预留 → 中继 → 结算"三段式（完整设计见 docs/context/architecture/money.md）：
- reserve：请求发出前，按目录价格从余额中预留预估金额（整数微美元，精度到 1e-6 USD）；
- settle：响应返回后按供应商实际报告的费用结算，多预留的部分当场退回；
- release：调用失败（超时、5xx 等）全额退款——失败不收费。
余额不足时返回 402，并附带balance_micro、estimated_cost_micro和充值入口，Agent 可以据此自动处理。另有一个容易被忽略的长期省钱点：同一问题的缓存命中从第二次起只按实价的 10% 计费。而 own-key 调用在缓存里也永不计量。
两个小例外：这些"own-key" 仍会计量
- X（Twitter）的按用量 OAuth：X 改为 pay-per-use 后，上游给"应用所有者"计费。如果你走 treg 的注册应用连接，这笔费用落在 treg 头上，所以这类调用仍会计量；但用你自己的 client_id/secret做的 BYO 连接（
/oauth/start携带自有凭证）永不计量。 - treg 没有公开价格的端点会被直接拒绝，而不是免费放行——它会明确提示你"接入自己的密钥"。这其实是又一次省钱指引。
省钱清单：开始调用前检查这 5 件事
- ✅ 列出团队已在付费的供应商订阅（Semrush、Moz、Apollo……），全部接入 treg——这是零边际成本的最大头；
- ✅ 用
treg upload env把.env里的存量密钥批量注册，避免遗漏； - ✅ 用
treg health确认凭证有效，避免"有密钥却走平台密钥"的隐性浪费； - ✅ 高频重复查询保持开启缓存，命中即按 10% 计费；
- ✅ 在 Activity 页定期审计调用，确认计费落在预期层级。
相关文档与源码入口：README.md（凭证阶梯原文）· docs/context/interface/dashboard.md（控制台操作）· src/treg/application/call/resolve.py（阶梯与计费决策实现）· docs/context/architecture/money.md（资金模型全解）
【免费下载链接】tregOpenRouter for agent tools. Join community here: https://discord.gg/6mQYYfFMAn项目地址: https://gitcode.com/GitHub_Trending/treg/treg
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
