treg X-Treg-Meta透传计费指南SaaS产品如何把treg API嵌入自己产品【免费下载链接】tregOpenRouter for agent tools. Join community here: https://discord.gg/6mQYYfFMAn项目地址: https://gitcode.com/GitHub_Trending/treg/tregtreg是agent 工具界的 OpenRouter——一个 base URL 一个 token就能调用 3000 个第三方 API 工具SEO、SERP、背链、社媒、企业数据、广告、抓取按次计费、无需注册供应商账号。如果你正在做 SaaS 产品想把这些能力嵌入自己的产品、并按自己的客户收费那么X-Treg-Meta透传计费就是为这种场景设计的一等公民机制treg 只负责计费和限额定价与收款永远由你说了算。为什么 SaaS 产品需要透传计费 先想清楚一个典型的业务结构你的终端客户 ── 你的 SaaS 产品 ── treg API ── 上游 60 供应商作为中间的平台方你需要三件事而 treg 恰好只提供这三件你需要的treg 提供的谁负责归因客户 X 本月消耗了多少X-Treg-Meta标签 usage/by-tag用量接口treg 记录限额客户 X 超支就拒绝按标签的每日/每月预算、blocked 状态treg 执行导出数字要干净到能直接开票账本级用量数据可逐条对账你拿来开票treg 从不向你的终端客户收款、不持有他们的卡、不设定他们的价格。差价、套餐、账单都是你自己的 Stripe 和你自己的生意。这种边界在 docs/CUSTOMER-BILLING-PLAN.md 里写得很直白treg meters and enforces; the builder monetizestreg 计量与执行构建方赚钱。而且官方明确表示在自有产品中调用 treg.to API 并做透传计费无需额外授权见 LICENSE 与 src/treg/web/llms.txt 的 Reselling treg inside your own product 一节。3 分钟接入把 treg API 嵌入你的后端 treg 提供三种接入方式产品集成首选 HTTP方式适合场景HTTPPOST {BASE}/call/endpoint-id你的后端本来就在发 HTTP 请求——产品的默认选择MCP{BASE}/mcp/你的 agent 运行时讲 MCP白送工具发现能力CLItreg脚本、CI、开发机不适合产品集成先用无需鉴权的 catalog 接口找到工具并看价格再正式调用# 1. 找工具、看价格无需 token GET {BASE}/catalog/search?qfacebookgroup GET {BASE}/catalog/endpoints/id # 2. 调用带上你的 token 和客户标签 curl --get {BASE}/call/endpoint-id \ -H X-Treg-Token: $TREG_TOKEN \ -H X-Treg-Meta: customercust_8123两个响应头是每个 SaaS 集成者必须记住的X-Treg-Cost-Micro—— 这次调用的真实成本整数微美元1e-6 USD。只在计费的调用上出现缺失说明走的是团队自有密钥、不计费。X-Treg-Call-Id—— 这次调用的稳定 ID。存进你自己的库它是你方记录与 treg 记录互相 join 的钥匙可通过GET {BASE}/calls/id回查。 小细节供应商自己的 4xx/5xx 错误会原样透传给你且不计费treg 自己的拒绝会打上X-Treg-Error: 1头——分支判断请看这个头而不是状态码。完整接入技能文档就在 src/treg/web/integrate.md官方建议直接把这份文件交给你的编码 agent 阅读。X-Treg-Meta 标签规则格式、上限与坑 ⚠️这是整个透传计费模型的核心一次调用可携带最多 5 个keyvalue键值对X-Treg-Meta: customercust_8123, workspacews_9, featurelead-enrichment解析与校验逻辑在 src/treg/application/call/intake.py规则要点规则说明key 格式[a-z0-9_]1–32 字符value 格式仅限字母、数字与. _ - :≤128 字符不能长得像邮箱整个 header≤512 字节违规行为一律422发生在转发之前——不产生任何费用也不烧掉你的Idempotency-Key两个值得注意的设计哲学拒绝而不是修复。treg 宁可报 422 也不会悄悄截断标签——因为一个被截断的 ID 会把你的两个用户合并到同一行账单上对不上的数字比没有数字更糟。customer是保留维度。任何键都可以用于分组统计但只有customer维度参与预算、blocked、幂等范围等强制语义——预算检查是热路径多一个维度就多看一次库。最重要的原则标签由你的后端设置绝不交给模型官方反复强调的一条铁律Set it in your code, never in a prompt.不要让 LLM 在工具调用参数里填这个 ID——长链路中模型总会丢掉它。你的后端本来就知道每个请求属于哪个客户、本来就在校验请求时设置X-Treg-Token就在同一个调用点把标签设上即可。所有 treg 调用收口到一个函数标签从请求上下文取两个调用点对客户归属的理解迟早会分叉。给客户设限额预算、拦截与安全拒绝 给某个客户设每日 $5 上限一条PUT搞定需要 admin token# 给 cust_8123 设 $5/天 curl -X PUT {BASE}/orgs/org_id/budgets/customer/cust_8123 \ -H X-Treg-Token: $TREG_TOKEN -H content-type: application/json \ -d {daily_cap_micro: 5000000} # 拉黑某客户限额保留随时可恢复 ... -d {status:blocked}几个关键行为限额可叠加workspace上限和customer上限对同时带两个标签的调用都生效拒绝信息会指明是哪个触发的。未设限则不设限设置某个键的第一个限额会顺带把它声明为预算维度最多 3 个。上限是建议性的它对着聚合值检查并发调用可能略超。你的预付费余额才是硬上限——别把它当成精确额度卖给用户。哪些拒绝可以安全地展示给你的终端用户这些拒绝体刻意不包含你团队的任何信息无余额、无充值链接可以安全透出403 {error:tag_blocked,dim:customer,val:cust_8123,message:…} 429 {error:tag_spend_cap_reached,dim:customer,val:cust_8123, spent_micro:5000000,cap_micro:5000000,period:day,message:…}反之团队级错误402 insufficient_balance、429 platform_daily_cap_reached里带着你的余额和充值 URL绝不能盲目转发给用户。给客户开票usage/by-tag 对账三件套 开票数据的唯一来源是这个接口admin 权限数据取自账本而非调用日志GET {BASE}/orgs/org_id/usage/by-tag?keycustomerdays30{key:customer,days:30, rows:[{value:cust_8123,charged_micro:41234,charged_usd:0.041234,calls:22}], attributed_micro:41234, unattributed_micro:1880, total_micro:43114}开票前必须记住三件事详见 docs/context/interface/api.md 的 Caller tags, budgets and per-tag usage 一节账本优先调用日志GET /calls在高负载下会丢行只适合调试永远不要用来开票。恒等式对账对任意 key 都有attributed_micro unattributed_micro total_micro不等就停下来排查别急着出货账单。unattributed_micro要收敛到零这是某个调用点忘了打标签的信号另外一笔调用会全额计入它的每个标签所以不同分组的数字不要相加。进阶标签不够用时用绑定 token做隔离 标签只是你的后端单方面声明的标签——当凭证要跑在客户自己的机器上时比如交付一个本地 agent需要真正的控制力。这时为该客户铸造一个绑定 tokentreg org agent-new cust-8123-bot --pin customercust_8123这个 token 永远只能给cust_8123计费试图指向别的客户直接403调用历史、归档结果、共享异步任务的可见范围也被锁定在这个标签内外部 ID 一律 404。官方的决策口诀一句话tag for counting, token for control标签管统计token 管控制。所有人都从标签开始只给极少数需要真实隔离的客户升级。上线前检查清单 ✅来自 src/treg/web/integrate.md 的 ship 前清单照着过一遍即可所有 treg 调用收口到一个函数X-Treg-Meta从请求上下文设置X-Treg-Call-Id已存入你自己的用量表账单读usage/by-tag并断言attributed unattributed totalunattributed_micro为零——或你知道哪个调用点漏了标签团队级402/429错误体由你自己处理绝不转发给用户重试带Idempotency-Key——重放返回缓存答案、不收费开启了自动充值或监控GET /orgs/id/balance余额为零时所有调用都会失败小结把 treg API 嵌入 SaaS 产品的透传计费路径其实非常清晰一个 token 接入 → 后端统一打X-Treg-Meta标签 → 按customer维度设预算 → 从usage/by-tag开票 → 需要隔离的客户升级绑定 token。treg 承担计量、限额与账本你承担定价与收款——这正是 README.md 所说的 OpenRouter for agent tools 对平台方该有的样子。 延伸阅读src/treg/web/integrate.md集成全攻略· docs/context/architecture/money.md计费架构· docs/CUSTOMER-BILLING-PLAN.md客户级计费设计【免费下载链接】tregOpenRouter for agent tools. Join community here: https://discord.gg/6mQYYfFMAn项目地址: https://gitcode.com/GitHub_Trending/treg/treg创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
