☰
2026年AI Agent工具接入终极指南:treg如何把60+供应商API变成按次计费
2026/9/25 6:26:51 网站建设 项目流程

2026年AI Agent工具接入终极指南:treg如何把60+供应商API变成按次计费

【免费下载链接】tregOpenRouter for agent tools. Join community here: https://discord.gg/6mQYYfFMAn项目地址: https://gitcode.com/GitHub_Trending/treg/treg

treg 是一个开源的 AI Agent 工具接入注册表("工具的 OpenRouter"):一个 Base URL、一个 Token,就能调用覆盖 60+ 供应商、3,000+ 端点的工具目录,按次计费、低至几分钱,且无需在各供应商处注册账号。本文带你 3 分钟跑通第一次调用,并看懂它"按次计费"背后的完整规则。

为什么AI Agent总卡在"工具接入"上?

让 AI Agent 干真活的工具,往往藏在没人会"只为跑一次"而购买的订阅后面:

工具官方订阅价为一次调用付费?
Semrush(SEO/外链)$139/月❌
Moz / Crunchbase$99/月❌
Apollo(联系人数据)$59/席/月❌

而且不少供应商根本没有公开 API——只开放给邀请制或合作伙伴。结果就是:Agent 有能力,却拿不到数据。

treg 的思路是:由平台持有这些供应商账号,调用者按次付费(pennies per call),"只问任务,不问工具"——搜索"我要做什么",看价格,直接调用。项目定位与动机见 README.md 与 docs/context/foundation/charter.md。

treg是什么:一个Key接入60+供应商API

treg 的核心设计可以概括为**"两类工具、一个 Token"**:

  • 公共目录(the catalog):treg 用自己的 Key 或已验证的公开路由为你提供服务。用自家 Key 的调用走团队预付费余额;匿名公开路由则免费。你不需要在任何供应商处有账号。
  • 你自己的工具:团队注册的付费 API 账号、OAuth 连接、供应商 CLI、SKILL.md技能包。自己的 Key 永远优先于 treg 的,且这些调用永不计费。

一切以**团队(org)**为边界:Token =(用户, 组织),密钥、工具、技能都归属当前组织,角色分 owner / admin / member / viewer。多租户模型详见 docs/context/architecture/multi-tenancy.md。

3分钟快速开始:调用你的第一个API

不需要任何供应商 Key,三步走:

# 1. 安装 CLI(同时指向注册表服务) curl -fsSL https://treg.to/install.sh | sh # 2. 登录(支持 GitHub / 邮箱验证码 / Agent Token) treg login # 3. 按"任务"搜索工具 → 直接调用 → 查看花了多少钱 treg catalog search "backlinks for a domain" treg call tikhub.tiktok.user.profile --query uniqueId=tiktok treg balance

💡 小技巧:treg catalog get <id>能查出任意工具的参数、价格和示例响应;treg onboard提供交互式引导。完整命令参考见 USAGE.md。

按次计费的4条规则:你的调用会被怎样结算?

treg 服务一次目录调用时,按顺序走这条**"凭证阶梯"**:

  1. 你的团队注册过该供应商的自有工具 → 用你的工具和 Key;
  2. 你的团队存过该供应商密钥 → 通过虚拟工具注入;
  3. 都没有,但该端点有已验证公开路由→ 无需供应商 Key,免费;
  4. 其余情况 → 用treg 自家 Key,从团队预付费余额计费。

两条重要细则:

  • 无价不服务:treg 没有公布价格的端点会被拒绝(而不是免费放行),并提示你接入自己的 Key。
  • 余额不足返回 HTTP 402,响应体携带balance_micro、estimated_cost_micro和topup_url——Agent 可以直接程序化处理,无需读人话。

底层安全原则:代理只"转发"而不"重建"上游 API,鉴权在服务端注入。调用者永远不持有密钥,上游 API 改版也不影响你。计费与结算机制(reserve → relay → settle)的完整设计见 docs/context/architecture/money.md。

真实价格:几分钱能买到什么?

目录中每个端点都有实测标注的价格,例如:

  • 找人邮箱(Hunter):按次计点,找一位企业邮箱、验证邮箱各按点数扣费,是目录中最便宜的联系人补全之一,见 src/treg/catalog/hunter.yaml;
  • 手机号/地址验证(TrestleIQ):$0.015 一次手机验证、$0.01 一次地址验证,仅成功的 HTTP 200 计费,失败请求免费。

多个供应商提供同一能力时,treg catalog search会把它们并排比价,由你选择——treg 不会偷偷替你在供应商之间切换。供应商目录数据全部存放在 src/treg/catalog/ 目录,每个供应商一份 YAML 定义 + 示例响应 JSON,可逐条审计。

团队共享:接入自己的Key,凭证永不出服务器

已有付费账号的团队,可以把凭证集中托管给注册表,全员(及各自的 Agent)共享,而密钥始终留在服务端加密存储:

treg scan # 只读预览:将注册哪些 key、skills、CLI treg upload # 一键注册(服务端加密),幂等 treg run stripe -- get /v1/balance # 注入凭证执行供应商 CLI

upload会扫描.env(匹配约 80 个已知供应商)、所有技能子目录和已安装的供应商 CLI。三类可共享对象:Endpoint(上游 URL + 凭证绑定)、CLI(注入凭证运行stripe/gh/vercel等)、Skill(SKILL.md配方 + 密钥 + 工具打包)。

团队成员在仪表盘中即可看到共享工具,一键"Copy for agent"或"Try it"在线试调:

给团队管理者:用量统计与权限审计

平台管理面板提供跨租户的总览:用户数、组织数、工具数、调用量、成功率,以及每个组织的成员与工具清单:

配合treg calls(调用审计日志)与treg health(凭证健康检查),管理员可以清楚知道"谁用了什么、花了多少"。

直连公共注册表,或自己托管?

  • 直接使用:访问公共站点 treg.to(Render 部署、多租户),新注册的合格团队首充送 $1.00 免费额度。
  • 本地自托管:一条命令启动开发环境(需tmux+uv):
scripts/dev-local.sh up # 服务跑在 http://localhost:18790

本地运行与部署细节见 docs/context/architecture/local-run.md 与 docs/context/ops/deploy.md。

延伸阅读 📚

  • 完整 CLI 参考:USAGE.md
  • Agent 引导文件:src/treg/web/llms.txt —— 一次抓取教会 Agent 整个注册表
  • Claude Code 插件安装:docs/CLAUDE-PLUGIN.md
  • 代理转发模型:docs/context/architecture/proxy-model.md
  • 密钥与鉴权架构:docs/context/architecture/auth-secrets.md
  • 前端仪表盘:frontend/

一句话总结:treg 把"为 Agent 逐个申请供应商账号"的繁琐流程,压缩成"一个 Key、一次搜索、几分钱的调用"——这正是 2026 年 AI Agent 工具接入该有的样子。

【免费下载链接】tregOpenRouter for agent tools. Join community here: https://discord.gg/6mQYYfFMAn项目地址: https://gitcode.com/GitHub_Trending/treg/treg

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询