如何读懂 treg 溢出中继X-Treg-Served-Via 披露机制完整指南【免费下载链接】tregOpenRouter for agent tools. Join community here: https://discord.gg/6mQYYfFMAn项目地址: https://gitcode.com/GitHub_Trending/treg/tregtreg 是一个开源的OpenRouter for agent tools——用一把统一密钥调用 2000 种 API 工具按次计费。它的**溢出中继overflow relay**是一层可靠性兜底当 treg 自己的平台账户余额耗尽或触发限流时请求会经由 treg 自有的聚合商账户中继完成同一接口调用并通过响应头X-Treg-Served-Via向调用方如实披露这次应答来自溢出中继。读懂这个机制你就能准确理解账单里每一笔费用的真实来源。溢出中继解决什么问题平台调用platform 凭证层默认走 treg 自己的供应商账户。当这个账户出现以下情况时调用可能失败触发条件说明余额/配额耗尽供应商返回余额不足、配额用尽等签名如 402突发 429突发限流且 treg 的平滑机制无法吸收账户已知耗尽skip-direct调度层已知平台账户不可用跳过直接尝试直接进入溢出流程此时溢出中继接力用 treg 自有的聚合商账户把完全相同的供应商请求包进聚合商信封发出再把供应商的原生响应取出来返回给你——同样的请求、同样的响应结构只是换了付费通道。X-Treg-Served-Via 如何工作披露有三个层次覆盖 REST 调用、MCP 客户端和价格预估三种场景响应头溢出中继成功时响应携带X-Treg-Served-Via: overflow:聚合商名称与X-Treg-Cost-Micro本次实际花费和X-Treg-Call-Id调用追踪 ID一起返回。头部缺省 平台账户直接完成调用方无需猜测。MCP 结果字段MCPcall结果中该头被转成served_via字段并附带提示文案方便 Agent 程序化读取。事前报价catalog_get在部署支持中继的接口上提前展示overflow_price_usd让调用方能引用中继价格做成本预估而不是事后才发现。注入点分别在 src/treg/application/call/service.py 与 src/treg/mcp.py。计费规则聚合商真实价格0% 加价子调用按聚合商上报的真实价格结算treg 不加价每个聚合商有独立每日预算默认 20 美元见 src/treg/config.py超出当日的溢出请求会被跳过模式三态overflow_modeoff默认从不触发shadow静默探测聚合商、记录状态与成本但调用方仍收到供应商原始错误不被计费——用于灰度验证on返回中继应答并打上X-Treg-Served-Via。失败边界一跳到底绝不换第二家只走一跳聚合商失败不会接力到第二家避免级联聚合商故障会被标记不健康 15 分钟调用方收到带备选接口列表的类型化 503且不产生任何费用永不触发场景使用团队自有密钥的调用、调用方参数错误导致的 4xx、超时、PUT/PATCH/DELETE 方法团队可用treg org overflow off整体退出溢出中继其请求永远不会被转到聚合商。在控制台中可以像普通调用一样查看溢出子调用的活动记录与费用相关代码与文档路径溢出主逻辑子调用循环、预算预留、结算src/treg/application/call/overflow.py聚合商信封适配器请求包装与应答解析src/treg/infra/upstream/aggregators/溢出路由与花费账本的数据迁移src/treg/alembic/versions/0006_overflow_route.py、src/treg/alembic/versions/0007_overflow_spend.py面向 Agent 的官方说明含中继披露条款src/treg/web/llms.txt回归测试tests/test_capacity_overflow.py、tests/test_influencersclub_overflow.py一句话总结treg 溢出中继让平台账户的钱荒不再等于服务中断而X-Treg-Served-Via让每一次中继都可观测、可计费、可审计——这是 treg 作为开源 API 工具网关在可靠性与透明度之间给出的工程答案。【免费下载链接】tregOpenRouter for agent tools. Join community here: https://discord.gg/6mQYYfFMAn项目地址: https://gitcode.com/GitHub_Trending/treg/treg创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考