OpenRouter

模型聚合网关(model aggregation gateway)。在 Jev 生态里,它是除 TypeSafe AI 官方 API 之外的第三方调用渠道之一:大量社区项目把 OpenRouter 与 Vercel AI Gateway、Cloudflare Workers AI 并列,作为可以互换的后端。

关键信息

  • 生态定位:TypeSafe 官方博客在讨论基线数据时提到其大模型数字取自 OpenRouter,并主动标注可能的偏差——“更复杂的查询可能被路由到更好的模型”。这是官方材料中唯一提到 OpenRouter 的位置,且是就对照基线而言,不是产品承诺。
  • 与其他渠道并列:社区项目普遍把 TypeSafe 直连 / OpenRouter / Vercel AI Gateway / Cloudflare Workers AI 设计成可切换后端,避免绑定单一供应商。
  • Jev 走 OpenRouter 的社区项目:
    • jev-cookbook(nexibeo/jev-cookbook)— 十五个可直接运行的 OpenRouter 配方(OpenRouter recipes),覆盖客服分诊、数据清洗、搜索、浏览器动作、Gmail 打标等,带小型标注样本与保存的真实结果;动作阈值留在代码里。
    • jev-cli(Nasrallah-AL/jev-cli)— TypeScript CLI,可跑在 TypeSafe、OpenRouter 或 Cloudflare Workers AI 之上。
    • jev-use(shitianfang/jev-use)— Claude Code / Codex / pi 插件,提供可互换的 TypeSafe、OpenRouter、Vercel AI Gateway 三种后端。
    • Jevtown(jevtown.ivanhabor.com)— 运行在 TypeSafe 或 OpenRouter 密钥之上。
    • Jev for Chrome — 浏览器扩展,经 OpenRouter、TypeSafe 或 Cloudflare 运行。
    • pi-verdict(jesset/pi-verdict)— 权限门控,Jev 后端经 OpenRouter 或 TypeSafe 直连提供。
    • jev-measured(WallerChen/jev-measured)— 通过 OpenRouter 对 Jev 的响应形状、成本、延迟做可复现测量,覆盖 8 类用例。
  • 一键切换:typesafe-sdk-php(Fox-Islam,社区 PHP 8.3 客户端,声明与 TypeSafe 无隶属关系)支持”一次调用在 TypeSafe 与 OpenRouter 的 decisions 端点之间切换”。落地该能力时需注意其声明:调用为同步、模型列表仅 TypeSafe 侧可用。
  • 注意:以上均为社区项目对 OpenRouter 的用法,不是 TypeSafe 官方文档对 OpenRouter 的承诺;社区清单特意提示”独立项目,包含不等于官方审核或认可”。

为什么社区偏爱网关

  • 多渠道容灾与可替换:Jev 的请求形状统一(state + questions),后端切换只需换端点与密钥,因而”同时支持三家”成本很低。
  • 统一计费与密钥管理:对同时使用多个模型的项目,网关可以复用同一套凭证与账务,减少每接一家供应商的接入负担。
  • 可测量的对照:jev-measured 这类项目专门经 OpenRouter 做可复现测量,说明网关也承担了”独立测量入口”的角色。

注意事项

  • 经网关调用时,模型版本可能不由调用方完全掌控;jev-ood-calibration 的记录指出”网关没有暴露固定的模型版本”,这会影响校准类实验的可复现性。
  • 官方 SDK / 文档仍以 TypeSafe 直连为主,别名 jev-latest 的默认行为也在官方侧定义;网关侧的模型列表与别名行为需另行核对。
  • 使用网关会把 state 内容经第三方转发,涉及数据保留(data retention)时应回到 TypeSafe AI 的 Legal 条款与零数据保留(ZDR)说明核对。

与哪些概念/实体关联

  • Jev — 被聚合/转发的目标模型。
  • TypeSafe AI — Jev 的开发方与官方直连渠道。
  • 模型路由 — 网关本身即”路由”这一概念的商业化形态;社区项目用它做多渠道容灾与切换。
  • Vercel — 同为 Jev 的第三方托管渠道,常与 OpenRouter 在项目里并列。
  • Agent — 多数走 OpenRouter 的项目都是智能体或开发工具链组件。
  • 工具调用 — jev-use、pi-verdict 等把 Jev 判断插入工具调用路径。