OpenRouter 发布 /tools API：agent 可程序化获取 Server Tools Marketplace 目录与定价，官方称包含市场最优价格

9 月 30 日，OpenRouter 在官方 X 账号发布新的 /tools API：让 agent 从 Server Tools Marketplace 抓取数据并以程序化方式使用，帖文称数据中「包括市场最优（best-in-market）的价格」。该帖还附了两张文档截图；同一线程的后续回复给出文档与市场页面的链接。

文档把新接口列在 Server Tools 指南的「Tools API」一节。工具目录可以以程序化方式获取，入口是两个 GET 端点：GET /api/v1/tools 列出每一个 server tool（模型可在请求中调用、执行由 OpenRouter 处理的一类工具）；GET /api/v1/tools/{name} 按规范名或任意被接受的别名返回单个工具，并列出原生运行它的模型。API 参考页对列表端点写得更细：输出内容包括每个工具在各类 API 格式下可用的 tools[].type 写法、它背后的执行引擎及其定价，以及有多少端点原生运行它。

两个 GET 端点，把整份工具目录交给代码

单工具端点按规范名或任意被接受的别名返回单个工具，并附带原生运行它的模型列表；路径参数接受 openrouter:* 形式的规范名，文档给的例子是 openrouter:web_search。

列表端点带三个查询参数：offset 与 limit 控制分页，limit 上限 100 条，两者都省略时返回完整列表；api_format 只筛选某一种 API 格式下可用的工具，可选值是 responses、chat-completions 与 anthropic-messages。两个端点都要求鉴权：在 Authorization 头里以 Bearer token 携带 API key。

每个工具条目的字段包括名称、状态、文档地址、aliases、engines、native_support，以及输入、输出、参数三类 schema（字段结构定义）。代码拿到的不只是「有哪些工具」，还包括每个工具怎么被调用、由谁执行。

引擎与定价写进响应结构

在响应结构里，定价挂在引擎条目下。每个工具条目带一个 engines 数组，其中每个引擎给出 id、名称、executed_by、byok、data_regions、default_mode 等字段；pricing 子数组里有价格、计价单位、计价模式与单次调用最大单位数，pricing_source 标注定价来源。

字段的组合意味着，调用方可以按价格、数据区域或执行方来挑选引擎；default_engine 与 fallback_engine 则标出默认与回退引擎。

native_support 用两个数字概括一个工具被原生支持的程度：多少端点、多少模型。文档解释了它为什么存在：部分供应商自带同类工具，例如 OpenAI 与 Anthropic 内置的 web search；当模型端点上有「原生」版本时，OpenRouter 可以转向供应商执行，而不是运行自己的引擎。

帖文提到的价格，落在响应里就是这些逐引擎的定价字段。对开发者来说，这意味着比价可以放进程序：调用目录接口，就能看到同一工具在不同引擎下的价格与执行条件。

市场推出不到一周，目录有了程序化入口

/tools 把 Server Tools Marketplace 的目录数据开放给程序读取。这个市场发布于 9 月 24 日，OpenRouter 当时的介绍是：为 agent 提供 grounding（让模型接入外部信息与工具）的「一站式」入口，包含 web search API、Shell、tool search 等。

市场页面上写得更具体：浏览 OpenRouter 代任意模型运行的 server tools（web search、web fetch、图像生成、沙箱 shell 等），比较供应商与定价；页面还提到工作区管理员可以在 workspace settings 里管理可用的 server tools。

按文档的工具清单，目录覆盖 web search、web fetch、datetime、图像生成、apply patch、shell、bash、fusion、advisor、subagent、search models、tool search 等条目；截图里的文档侧栏中，这些条目大多标注 Beta。市场页面面向「浏览」和「比较」，新上线的接口则面向程序读取。

目录里的工具在请求里如何运作

文档把 server tool 定义为模型可以在一次请求中零次或多次调用的工具，执行由 OpenRouter 透明处理。调用分四步：请求的 tools 数组带上一个或多个 server tool；模型根据用户提示决定是否、何时调用；OpenRouter 拦截调用、在服务端执行、把结果交回模型；模型据此组织回答，必要时再次调用。

server tool 可以和用户自定义工具放在同一个请求里；使用它们的请求有一个步数预算，每次工具调用消耗一步，预算用尽后，模型会被要求用已收集的上下文给出最终答案。工具用量会被记入响应的 usage 对象。

Beta 标注与调用边界

Server tools 整体仍标注为 Beta，文档同时保留了一句：API 与行为可能变化。

经测试，不带凭证请求 GET /api/v1/tools 会得到 401 响应。据市场页面，工作区管理员还可以在 workspace settings 里管理可用的 server tools。

至于价格，「市场最优」目前仍属于发布方的表述；接口给出的是逐引擎的定价字段。

参考链接

— OpenRouter 公告帖（/tools API）
— 同线程回复（文档与市场链接）
— Server Tools 文档
— List server tools API 参考
— Get a server tool API 参考
— Server Tools Marketplace 发布帖
— Server tools 市场页面