
Jev 入门指南:三张图说透、4 个开源项目、API Key 手把手获取
本文宗旨:用最少废话、最清晰的图解,带你上手 TypeSafe 结构化决策模型 Jev。
简单来说,它的工作就是代替你在软件中做那些最频繁、最繁琐的小判断——它不擅长写诗或聊天,但判断速度极快,输入每百万 token 只要 0.042 美元,输出完全免费。
已经有人用它做出了 4 个非常硬核的工具:自动操作浏览器、时间线内容过滤、精准文献精筛、Claude Code 历史记录压缩。
这篇通过三张概念图讲清核心原理,接着按 2026 年最新实操截图带你获取 API Key,最后奉上这 4 个开源项目,带你找到最适合自己的体验入口。
💡 阅读地图:
- 1️⃣ Jev 是什么?
- 2️⃣ 哪些场景适合交给它?
- 3️⃣ 最新 API Key 获取指引
- 4️⃣ 4 个硬核开源项目精选
1️⃣ Jev 是什么?先看一道选择题
Jev 是 TypeSafe 推出的结构化决策模型。你可以把它想成一个按题目要求作答的判断员。
比如,给它这样一组内容:
内容:快递还没到。问题:这条消息属于哪一类?选项:售前、物流、售后。
这里的重点是:选项由你提供。Jev 理解这句话,再判断它更符合哪一类。

如果返回的类别是“物流”,你的软件就可以把消息放进物流工单队列。至于回复客户什么、要不要查询快递,还要由后面的程序或其他模型处理。
Jev 当前不提供自由文字生成。它的返回形式是事先约定好的选择、概率或评分,方便程序继续处理。官方介绍
除了选类别,还能判断什么?
围绕同一条消息,可以问不同类型的问题。
你想知道什么:这条消息归哪类?
- Jev 的题型:Choice,选择题
- 返回形式示意:从“售前/物流/售后”中选一个
你想知道什么:这条消息需要回复吗?
- Jev 的题型:Noul,是非概率
- 返回形式示意:0~1 之间的数值
你想知道什么:这条消息有多紧急?
- Jev 的题型:Score,评分题
- 返回形式示意:按你定义的标准给分
这三种题型,不需要一开始就背下英文名字。先记住它们分别适合“选哪个”“有多大可能是”“达到什么程度”。

有两处容易理解错。
Noul 返回 0.85,表达的是模型对“需要回复”这个判断的概率估计,不代表它有 85% 的正确率。如果界面显示“需要回复”,那是程序按设定的阈值转换出来的。
Score 则要先定义评分标准。比如哪些情况算普通、紧急、非常紧急。返回值可以是 3.7 这样的小数,不只限于预设的整数档位。Choice 还会提供选项概率和置信度,图里为了好理解,省略了这些字段。题型文档:Choice、Noul、Score
https://typesafe.ai/2️⃣ 什么事情适合交给 Jev?
留意软件里的那些小判断,就比较容易找到用途。
一篇文章进来了,要不要收进资料库?一条消息到了,该分到哪个类别?AI 正在操作网页,下一步应该点哪个按钮?
这些任务有一个共同点:可以提供判断所需的内容,并把问题和回答规则说清楚。
应用一次要判断很多条内容时,单次速度和费用就会影响使用体验。TypeSafe 对 Jev 的定位,也正是软件中频繁发生的结构化判断。产品说明
不过,选对题型只是开始。
如果消息只写了“还没到”,没有前后文,它说的是快递、转账,还是约好见面的人?提供的信息不同,判断就可能不同。把答案限制在几个选项里,也不能保证选到正确的那个。
https://github.com/tamaratran/fast-jev-compaction所以,适合自动处理到什么程度,要看具体任务。给收藏内容打标签,可以允许一些误判;会造成实际损失的操作,就需要更严格的校验。
https://console.typesafe.ai/playground3️⃣ 直接从官方获取 API Key
API Key 可以理解成调用凭证。工具拿着它访问模型,平台据此识别账户,并记录使用量。
现在可以直接登录 TypeSafe 官方控制台获取 Key。后面的四个推荐项目都支持官方 Jev Key,部分项目还需要文字模型或搜索服务的凭证,推荐部分会单独说明。
从官网进入控制台
打开 TypeSafe 官网,点击右上角的 API Console。

完成首次设置
按提示完成登录,首次进入会看到 Review our terms 页面。阅读条款,确认同意后勾选第一项,再点击 Continue。
下面的产品更新邮件订阅,按自己的需要选择。
https://openrouter.ai/typesafe/jev-1.13然后是 Let's create your org 页面。可以填写组织名称、团队规模和账单国家,再点 Next;暂时不设置,也可以点击 Skip 跳过。
填写时按自己的实际情况选择,不必照抄截图里的内容。

进入控制台,完成一道小测
来到 Meet Jev 介绍页,点击右下角的 Enter console。
https://docs.typesafe.ai/primitives/noul进入后会弹出一道小测:Can you chat with Jev, TypeSafe's new model? 意思是“能和 Jev 聊天吗?”
这道题选择 No。正好对应前面讲过的区别:Jev 按设定的问题给出判断,当前不自由生成聊天回复。
创建 API Key
点击左侧的 API Keys,再点页面中间的 Create key。
https://typesafe.ai/legal/mca在弹窗的 Key name 里填一个方便辨认的名称,例如 jev-demo,然后点击 Create key。
https://jev.s1.dev/复制保存,再关闭弹窗
看到 API key created,就说明创建成功了。先点击 Copy,把 Key 保存到安全的位置,再点击 Done。
页面明确提醒:完整 Key 只显示一次。先确认已经保存,再关闭弹窗。
https://docs.typesafe.ai/primitives/score拿到后,在所选项目的配置中填写。如果文档要求 TYPESAFE_API_KEY,指的就是这里创建的官方 Key。完整 Key 不要放进公开截图、仓库或文章里。
调用前,看一眼费用
Jev 官方当前标价为:输入每百万 token 0.042 美元,输出免费。Token 是模型计量文本用量的单位,不直接等于汉字数。官方模型价格
实际调用会消耗账户额度。是否有赠送额度、首次充值金额和支付方式,以账户页面显示为准。官方计费条款
只想先看看“放入内容、提出问题、得到判断”的过程,可以从左侧打开 Playground。

OpenRouter 和 Vercel 仍可作为补充
平台:OpenRouter
- 什么时候考虑:已有账户,或想看它的 Jev Labs 示例;确认所用工具明确支持 OpenRouter 的 Jev 接口
平台:Vercel AI Gateway
- 什么时候考虑:想尝试限时活动,或所用项目已经支持它;当前 Jev 免费促销截止 2026 年 9 月 25 日,之后查看最新价格
不同平台的 Key 不能直接互换。选择官方路线后,就按项目中的 TypeSafe 配置填写;需要其他平台时,再查看对应的接入和费用说明。
4️⃣ 四个值得点开的开源项目
jev-ultrafast:告诉它目标,让浏览器自己点、自己填
查航班时,要选出发地、目的地和日期,再等网页给出结果。jev-ultrafast 把这一串网页操作交给程序,你提供目标,它一步步完成点击、输入和选择。
作者提供的 Google Flights 演示,展示了查询苏黎世到伦敦航班的过程。想看“模型做判断”怎么变成屏幕上的实际动作,可以先点开这段视频。作者演示
每一步,程序把当前网页上的按钮、输入框等控件整理给 Jev,让它选择操作和目标。需要填写文字时,再由辅助文字模型提供内容。这也解释了 Jev 如何参与自动操作:判断、写文字、执行动作,各有对应的部分。
项目需要 Python 和 Chrome 环境、TypeSafe 官方 Key,以及文字模型的调用凭证。示例中的文字模型可以走 OpenRouter,但 Jev 的判断仍使用官方 Key。项目与配置说明
当前它聚焦浏览器内的网页操作。演示完成的是航班查询,停在可选航班列表。
Your Signal:让 X 少显示你不想看的帖子
刷 X 想找点有用的东西,却不断遇到推广和求互动的帖子。Your Signal 让你自己设置关注的话题,以及对相关性、实用性、推广内容的偏好。
Jev 根据这些要求判断帖子,Chrome 插件再把内容高亮、淡化、折叠或隐藏。觉得过滤太狠,可以调整阈值,也可以恢复被隐藏的帖子。
它吸引我的地方,是把“这条对我有没有用”变成了自己能调的规则。对于经常在 X 找工具、看观点、收集选题的人,这个用途很直接。
目前需要手动加载 Chrome 扩展,并配置 TypeSafe 官方 Key。它处理的是时间线上已经显示的帖子文本,图片和外链内容不在判断范围内,也不负责核实真假。
先看作者提供的信息流过滤演示,会比只读功能列表更容易理解。Your Signal 项目与演示入口
Jev Search:把想找的资料说清楚,让它帮你筛链接
想找某款电脑在 Reddit 上的使用反馈,或者最近一段时间的论文,你往往得换关键词、切网站,再逐条判断结果有没有关系。
Jev Search 把这些步骤放进一个搜索界面。你描述需求,Jev 判断该选哪些来源、什么时间范围;搜索服务找回结果后,它再根据标题和摘要判断相关性。
你看到的是链接、摘要和相关性评分。觉得来源或时间不合适,还能在界面里调整。经常为文章找资料、做选题研究的读者,可以重点看这一项。Jev Search 项目
作者提供了在线体验入口,本文未验证在线搜索效果。自己部署时,需要 Search1API Key,再选 TypeSafe、Vercel 或 Cloudflare 中的一种 Jev 接入方式。搜索服务和模型各有使用条件。
这里 Jev 负责选择和筛选,真正联网搜索的是配套服务。相关性高,表示结果更贴近问题,不能当成内容已经核实。
fast-jev-compaction:给 AI 编码助手腾出上下文空间
让 AI 连续改代码,一段任务里可能积累很多文件读取、报错、重试记录。到了后面,一次已经过时的工具输出,还占着助手能读取的空间。
这个项目让 Jev 判断哪些旧工具调用和结果值得保留,再由程序保留、截短或删除。留下来的内容沿用原文,文件路径、报错文字等信息可以继续供助手使用。
如果你经常用 Claude Code 完成长任务,可以重点看看它如何处理积累下来的旧记录。筛掉过时的输出,就能给后续任务留出空间。项目与安装说明
项目提供 Claude Code 插件和 npm 库,默认使用 TypeSafe 官方 Key。插件还需要满足 Function Hooks 的版本与启用要求。删减记录仍可能丢掉有用信息,不能把它理解成无损压缩,也不能据此承诺省下固定比例的 token。
想看自动操作网页的效果,先点开 jev-ultrafast 的作者演示。经常刷 X、搜资料或用 AI 写代码,再按自己的需要看后面三项。先找到用得上的方向,再考虑 Key 和安装。
https://github.com/browser-use/jev-ultrafast/blob/main/docs/demo.mp4写在最后
都看到这里了,还不 点赞 + 关注 + 转发 走一波吗。你的支持是我更新最大的动力。