treg 密钥优先own-key always wins规则详解4 种方式降低 API 调用成本完整指南【免费下载链接】tregOpenRouter for agent tools. Join community here: https://discord.gg/6mQYYfFMAn项目地址: https://gitcode.com/GitHub_Trending/treg/tregtreg 是一个面向 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 余额目录工具catalogtreg 平台密钥 / 免密钥公开路由可能见下文阶梯你自己的工具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.mdtreg 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.mdreserve请求发出前按目录价格从余额中预留预估金额整数微美元精度到 1e-6 USDsettle响应返回后按供应商实际报告的费用结算多预留的部分当场退回release调用失败超时、5xx 等全额退款——失败不收费。余额不足时返回 402并附带balance_micro、estimated_cost_micro和充值入口Agent 可以据此自动处理。另有一个容易被忽略的长期省钱点同一问题的缓存命中从第二次起只按实价的 10% 计费。而 own-key 调用在缓存里也永不计量。两个小例外这些own-key 仍会计量XTwitter的按用量 OAuthX 改为 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），仅供参考 treg 密钥优先（own-key always wins）规则详解：4 种方式降低 API 调用成本（完整指南）
treg 密钥优先own-key always wins规则详解4 种方式降低 API 调用成本完整指南【免费下载链接】tregOpenRouter for agent tools. Join community here: https://discord.gg/6mQYYfFMAn项目地址: https://gitcode.com/GitHub_Trending/treg/tregtreg 是一个面向 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 余额目录工具catalogtreg 平台密钥 / 免密钥公开路由可能见下文阶梯你自己的工具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.mdtreg 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.mdreserve请求发出前按目录价格从余额中预留预估金额整数微美元精度到 1e-6 USDsettle响应返回后按供应商实际报告的费用结算多预留的部分当场退回release调用失败超时、5xx 等全额退款——失败不收费。余额不足时返回 402并附带balance_micro、estimated_cost_micro和充值入口Agent 可以据此自动处理。另有一个容易被忽略的长期省钱点同一问题的缓存命中从第二次起只按实价的 10% 计费。而 own-key 调用在缓存里也永不计量。两个小例外这些own-key 仍会计量XTwitter的按用量 OAuthX 改为 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），仅供参考