如何使用 Jev API:20 個你可以直接複製的專案
拿到了 TypeSafe Jev API 金鑰卻不知道要拿它做什麼?二十個以 Jev 為基礎的開源專案——網頁代理、編碼代理的管線、MCP 伺服器、shell 過濾器、無人機與交易示範——附上星數、語言、授權,以及那些其實並非 Jev 原生的專案。
發布於 2026-09-22
Jev 金鑰不是聊天金鑰,所以常見的「hello world」並不存在。 沒有 messages 陣列,也沒有可串流的 completion。你得到的是一個端點——POST /v1/systemone——它接收一個 state 加上一組具型別的問題,並回傳帶有機率的 Choice、Score 與 Noul 答案。以下每個專案都是某個人對「那我到底該把它指向什麼?」的回答,而且這二十個全都是開源的。
在 APIMaster 上以 jev-latest 執行 Jev。 即時路由的價格是每 1M 輸入 token $0.042,輸出 $0(一條啟用中的路由,查核於 2026 年 9 月 22 日),這與 TypeSafe 公布的每十億輸入 token $42 相符——沒有閘道加價,也沒有東西可以打折,因為根本沒有輸出 token 可計費。用你的 APIMaster 金鑰呼叫原生合約 POST https://apimaster.ai/v1/systemone。請見 Jev 市集卡片。
折扣在你搭配的模型上。 Jev 負責決策;由別的模型負責寫出文字。那些層級正是 APIMaster 遠低於定價表的地方:gpt-5.6-luna 從每 1M token $0.0223 輸入 / $0.1336 輸出起(3 條路由,約比 OpenAI 的 $0.20 / $1.20 低 89%)、gpt-5.6-sol 從 $0.2682 / $1.6095 起(18 條路由,約比 $5 / $30 定價表低 95%)、claude-haiku-4-5 從 $0.09 / $0.45 起(8 條路由,約比 $1 / $5 定價表低 91%),以及 glm-5.3-flash 從 $0.105 / $0.35 起(4 條路由,約比 Zhipu 定價表低 30%)。一把金鑰就能涵蓋 Jev 與所有文字模型家族——請見 Luna 卡片與市集。路由價格會隨通路供給變動,所以即時卡片上的數字才算數。
安裝任何東西之前,先讀成熟度警告。 這二十個儲存庫中有十五個是在 2026 年 9 月 16 日至 9 月 18 日之間建立的。一週大的儲存庫上的星數衡量的是關注度,不是可靠性。有五個的星數低於 60,而這二十個之中有三個——json-render、agent-desktop 與 prism-liquidity-agent——根本不是 Jev 原生:它們早於這個生態系,沒有 Jev 也能運作。詳情見最後一節。
GPT 體驗卡(GPT-6 Astra、GPT-5.6、GPT-5.5和GPT Image 2 可用)
現在註冊,領取 $20 GPT 體驗卡
Jev 是什麼,以及它為何改變了「專案」的樣貌
TypeSafe 於 2026 年 9 月 15 日推出 Jev,作為第一個「System One 模型」。賣點是 Kahneman:當今的 LLM 是緩慢、審慎的系統,而 Jev 是快速的那個——只不過這裡的「直覺」是你所定義選項上的一個校準過的機率分布,而不是散文。
正是這個單一設計選擇,讓以下專案看起來完全不像常見的「AI 包裝器」清單:
- 輸出是具型別的。 你宣告
Choice(從你的選項中挑一個)、Score(依你命名的等級評分),或Noul(某個是/否陳述成立的機率)。沒有東西要解析,也沒有 schema 要祈禱。 - 每個問題都在一次處理中回答。 state 只被吸收一次,所有問題一起對它評估,所以問三十個問題的成本幾乎不比問一個多多少。
- 輸出免費,因為根本沒有輸出。 回應端沒有字串、沒有序列結構、沒有輸出 token——這正是價格只算輸入的原因。
- 模型不會行動。 它做判斷。任何帶有副作用的東西——點擊、飛行、下單、刪除——都留在普通程式碼裡,以機率門檻為閘。
一旦你看見這個形狀,專案空間就自己寫出來了:把 Jev 呼叫放在你的程式即將做出一個小型、高頻、難以用 if 表達的決策之處。
20 個專案一覽
星數查核於 2026 年 9 月 22 日。
| # | 專案 | ★ | 語言 | 功能 |
|---|---|---|---|---|
| 1 | browser-use/jev-ultrafast | 16,972 | Python | 瀏覽器代理,由 Jev 挑選操作與元素;只有在動作為 TYPE_TEXT 時才由 LLM 撰寫文字 |
| 2 | tamaratran/fast-jev-compaction | 6,122 | TypeScript | Claude Code 外掛,以 Jev 刪除取代壓縮摘要——任何內容都不會被改寫 |
| 3 | vercel-labs/json-render | 18,005 | TypeScript | 生成式 UI 框架。並非 Jev 原生 |
| 4 | itsmostafa/typesafe-mcp | 238 | Go | 供 Claude Code、Claude Desktop、Codex 與 pi 使用的 evaluate MCP 伺服器 |
| 5 | jkudish/jev-mcp | 257 | JavaScript | 透過 MCP 暴露的十個具型別判斷工具 |
| 6 | sharziki/semdecide | 32 | Python | 「意義的 grep,判斷的 jq」——具型別決策作為帶有真實退出碼的 Unix 過濾器 |
| 7 | 0xNatoshi/jev-codex-router | 189 | JavaScript | 由 Jev 驅動的 Codex 逐次呼叫模型與思考強度路由 |
| 8 | GhalebDweikat/winnow | 60 | Python | Claude Code 的上下文篩網:把 Jev 確信你不需要的工具輸出挖掉 |
| 9 | devagrawal09/jev-review | 516 | TypeScript | 帶有本機儀表板的階段式程式碼審查工作流程 |
| 10 | ellipsis-dev/blink | 56 | TypeScript | 透過 Jev 引導的漫遊者集成進行程式碼庫搜尋 |
| 11 | lahfir/agent-desktop | 1,454 | Rust | 透過作業系統無障礙樹進行的桌面電腦操作。並非 Jev 原生 |
| 12 | fhshaik/typesafe-mario | 343 | Python | Jev 從模擬器 RAM 玩 Super Mario Bros.,絕不從螢幕截圖 |
| 13 | RomanSlack/jev-drone | 122 | Python | 四旋翼飛越 MuJoCo 障礙賽道;Jev 以約 2.5 Hz 讀取情境 |
| 14 | emrickgarrett/OneVOneJev | 20 | TypeScript | 伺服器權威的瀏覽器 FPS,你與 Jev 對戰,先取得 5 次擊殺者勝 |
| 15 | jarrodwatts/jev-trader | 1,929 | TypeScript | 在 Kuru MON-USDC 訂單簿上,每個 Monad 區塊做一次買或賣決策 |
| 16 | irfndi/prism-liquidity-agent | 71 | TypeScript | Solana Meteora DLMM 流動性代理。並非 Jev 原生 |
| 17 | jexp/neo4jev | 84 | Python | 一次一躍的圖導航,目標檢查搭在同一呼叫中 |
| 18 | AkashPriyadarshii/jev-curate | 23 | Rust | 針對 JSONL 與 Parquet 語料庫的資料集篩選器 |
| 19 | qkal/Canny | 32 | JavaScript | 不讓編碼代理僅憑一句聲稱就收工的看守者 |
| 20 | monteduro/killmyidea | 82 | TypeScript | 八個評分問題,加權成 KILL / FIX / SHIP |
第 1 組 — 做決策而非生成的代理
browser-use/jev-ultrafast (★16,972) 是參考實作,也是第一個該讀的專案。 瀏覽器代理通常會要求模型輸出一個 JSON 動作,這意味著每一步都要為 token 付費。Ultrafast 將工作拆開:Jev 從一個已建立索引的動作空間中挑選一個操作和一個元素,而小型 LLM 只在所選操作為 TYPE_TEXT 時才會被呼叫——這是唯一需要生成字元的情況。README 的頭條示範,一次在 Google Flights 上真實的蘇黎世 → 倫敦搜尋,在7.1 秒內完成,包含文字生成與頁面載入。如果你想理解為什麼決策模型值得擁有,這個 repo 就是論據。
lahfir/agent-desktop (★1,454) 是桌面端的對應版本——而且它不是 Jev。 它是一個 Rust CLI 與 C-ABI 函式庫,透過作業系統的無障礙樹讀取應用程式的真實 UI 結構,而非從像素猜測,具備 54 個操作指令,以及跨呼叫保持穩定的快照參照。它自己的 README 聲稱,在密集應用程式上透過骨架遍歷可減少 78–96% 的 token。它創建於 2026 年 2 月,遠早於 Jev,且不依賴它。它在這裡佔有一席之地只有一個原因:如果你正在打造 Ultrafast 的桌面版本,這就是你會在其上放置 Jev 呼叫的感知層。
第 2 組 — 編碼代理的管線
這是生態系最厚實的地方,因為編碼代理產出兩件 Jev 最擅長判斷的事:這是否仍然相關?以及這是否真的完成了?
fast-jev-compaction (★6,122) 採用了最常見的模式——用 LLM 摘要舊脈絡——並加以否定。摘要有損;一個檔案路徑或一個確切的錯誤可能就此消失。這個外掛從不改寫任何東西。它把整個對話展示給 Jev,詢問哪些工具呼叫與結果已不再需要,然後只刪除那些。使用者與助手的文字保持逐字且依序不變。
winnow (★60) 將同樣的想法套用到個別結果而非歷史紀錄上。每個大型的 Read、Bash 或 Grep 輸出在進入脈絡前都會被判斷;Jev 確信你不需要的區塊會被替換成三行摘要,附上一個廉價模型的摘要,以及一個可依需求還原完整文字的鍵。沒有任何東西遺失,只是在你要求之前不再耗費 token。Winnow 也是優雅降級最乾淨的範例:當 Jev 無法使用時,它的轉接器可以用 Claude Haiku 4.5 回答相同的問題——未經校準,但能讓管線持續運作。
Canny (★32) 攻擊的是相反的失敗。代理會聲稱成功。Canny 掛接到 Claude Code 與 Codex CLI,保留一份代理實際做了什麼的帳本,並拒絕讓它僅憑聲稱就結束——它會依據完成聲明來判斷工具輸出、diff 與測試結果。
jev-review (★516) 在人類看到 diff 之前執行:先是一個 Noul 風險矩陣,然後針對檔案輪廓、證據選擇、機制分類與嚴重性進行 Choice 與 Score 呼叫,並以條件式 Choice 決定審查者路由。閾值與政策留在程式碼中,結果則落在本地儀表板。
blink (★56) 將 Jev 用作程式碼庫導航器:walker 沿檔案樹向下走,並在每一層詢問哪些檔案對查詢重要。注意授權條款——該 repository 沒有授權檔案,如果你打算發佈它,這點很重要。
jev-codex-router (★189) 是會影響你帳單的那一個。它內嵌了一個 Codex Router 分支,並讓 Jev 為每次模型呼叫選擇一個模型以及一個思考強度,包括工具之後的續接。README 報告了一個歷史模擬,在 237 輪中相較於全程執行完整 Astra 約為 −60%——並且謹慎地說明這並非實測節省的 Codex 配額,也不描述當前政策。把它當作一種方法,而非保證。
第 3 組 — MCP 伺服器,如果你只想要工具
jkudish/jev-mcp (★257) 將十種判斷註冊為 MCP 工具:jev_verify(依據證據驗證聲明)、jev_screen(內容進入脈絡前先篩選)、jev_find 與 jev_rerank(候選選擇與排序)、jev_classify、jev_decide、jev_compare、jev_extract、jev_review 等等。任何 MCP 客戶端都能呼叫它們。
itsmostafa/typesafe-mcp (★238) 是更小、更主觀的選項:一個以 Go 撰寫的單一 evaluate 伺服器,具備一行指令設定——evaluate setup mcp 若找到 Claude Code、Claude Desktop 與 Codex 就會將其接上,而 evaluate setup pi 則涵蓋 pi。如果你想要五分鐘內就有一個可用的工具,而不是一個要設定的工具箱,就從這裡開始。
TypeSafe 本身不隨附任何 MCP 伺服器;這兩個都是社群作品。
第 4 組 — shell、CI 與資料管線
semdecide(★32) 是這組裡最像 Unix 工具的專案,而它的描述精準到位:用 grep 找意義,用 jq 做判斷。把文字或 JSONL 餵進去,就能得到一個述詞、一條路由、一個分數、一條過濾後的串流,以及一個真正的行程結束碼——完全不必自己寫提示詞、解析、重試或信心度處理的黏著程式碼。它的 README 範例問的是:一筆來自新國家的登入緊接著一筆出金,是否「描述了一個合理的帳號盜用情境」,然後得到 TRUE probability=0.860 threshold=0.700。這種東西你今天就能放進 shell 腳本、GitHub Action 或 cron job 裡。
jev-curate(★23) 是訓練資料的批次版本:把 JSONL 與 Parquet 語料串流過具型別的 Choice / Score / Noul 決策,並支援推測式扇出。README 的目標是每秒 1,500 筆以上;這是設計目標,不是經獨立重現的數字,所以在信任這個吞吐量之前,請先用自己的資料做基準測試。
第 5 組 — 即時、實體與對抗式系統
這些都是展示專案,而它們是這套架構站得住腳的最佳證明:在每一個專案裡,困難且安全關鍵的迴圈都留在普通程式碼中,Jev 只負責回答一個小問題。
typesafe-mario(★343) 從不讓 Jev 看到螢幕畫面。測試框架把模擬器遙測與 RAM 轉成精簡的 JSON——移動、跳躍軌跡、即將出現的敵人、地形、實測輸入延遲、近期控制結果——再由 Jev 從一組很小的合法動作中挑選(noop、right、right_jump、right_run、right_run_jump、jump)。
jev-drone(★122) 只靠機載相機,讓一個真實機體模型(來自 MuJoCo Menagerie 的 Skydio X2)飛越五站式障礙賽道。分層非常明確:500 Hz 的幾何控制器負責飛行,50 Hz 的導引層永遠掌握安全,而 Jev 大約坐在 2.5 Hz 的位置,判斷當下情境代表什麼意義。README 說得很直白——Jev 不是視覺模型,無法以控制頻率執行。
OneVOneJev(★20) 是一款伺服器權威制的瀏覽器 FPS,Jev 就是你的對手:排隊進場,在類似 Rust 風格的工業場地裡與它對戰,先拿到 5 次擊殺者勝,旁觀者在一旁觀戰。每個決策週期都必須回答移動、瞄準、開火與跳躍。
jev-trader(★1,929) 在 Kuru 的 MON-USDC 訂單簿上,每個 Monad 區塊送出一筆 post-only 限價單,價格落在買賣價內一檔,並取代前一筆。在沒有 PRIVATE_KEY 的情況下,它會以模擬成交對真實訂單簿進行 dry-run——另外請注意,預設模型是 mock,一個動量啟發式的替代品,所以這隻機器人在你連金鑰都還沒有之前就能跑。
prism-liquidity-agent(★71) 是第三個非 Jev 原生的專案:一個基於規則的代理,每十分鐘透過 recall → observe → reason → simulate → decide 的循環,在 Solana 的 Meteora DLMM 上重新平衡集中流動性部位。它建立於 2026 年 6 月,並未使用 Jev。之所以收錄,是因為它是目前最清楚的一個已發表範例,展示了那種形狀——確定性迴圈,末端接一個有界的決策——而 Jev 呼叫正好可以嵌進那個位置。
第 6 組 — 圖、結構與想法
neo4jev(★84) 一次一躍點地導航 Neo4j 圖。在每個節點上,向外的關聯會變成帶有屬性的 Choice 選項,而一個 Noul 問題——「是否已達成目標?」——會搭在同一次 systemone 呼叫中,因此無論你問多少問題,每一躍點都恰好只花一次來回。對回傳的機率做 top-k 選取,就把它變成以對數機率總和排序的集束搜尋。如果你想看平行提問被用得恰到好處,讀這個專案。
json-render(★18,005) 是表中最大的 repo,也是關聯性最低的一個:Vercel Labs 的生成式 UI 框架,建立於 2026 年 1 月,它從預先定義的元件與動作渲染動態介面,而不是從原始 JSON。它不是 Jev 原生的。兩者的連結是概念上的——它的賣點是「讓模型在安全、預先定義的選項中做選擇,而不是輸出自由形式的內容」,這正是 Jev 的賣點套用到 UI 上。基於這個理由,它出現在許多 Jev 彙整文章中;別期待 package.json 裡會有 TypeSafe 相依套件。
killmyidea(★82) 是這裡最小的一個完整產品:描述一個創業點子,Jev 就會在單一平行請求中回答八個獨立開發者問題,每個以 0–4 評分,外加類別與清晰度。每個分數乘以 25,加權成平均,通過清晰度閘門,然後回傳為 KILL IT、FIX IT 或 SHIP IT。整個迴圈裡完全沒有生成式 LLM。
你的第一個請求
取得金鑰,然後呼叫原生合約——而不是 Chat Completions:
curl -X POST "https://apimaster.ai/v1/systemone" \
-H "Authorization: Bearer $APIMASTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"state": "Help! My payouts have been failing for 3 days.",
"model": "jev-latest",
"questions": {
"is_urgent": { "type": "noul", "instructions": "Does this convey urgency?" },
"category": { "type": "choice", "options": ["billing", "technical", "other"],
"instructions": "Which team should handle this?" }
}
}'
接著從表格中挑選一個專案,閱讀它的 README,並從清單上最小的整合開始——如果你住在終端機裡,就選 semdecide;如果你住在 agent 裡,就選 jev-mcp。把閾值和副作用留在你自己的程式碼中,並將回傳的機率視為你據以把關的東西,而不是你服從的東西。
在你安裝其中任何一個之前
- 年齡才是風險,不是想法。 二十個 repo 中有十五個是在 2026 年 9 月 16 日至 18 日之間建立的。它們只有幾天大,大多由單一作者撰寫,有些自發布當天起就再也沒被碰過。
- 星星數衡量的是關注度。 一個六天前建立、擁有 16,972 顆星的 repo 獲得了巨大的曝光,卻幾乎沒有生產環境的實戰經驗。在它觸及錢包、你在意的 repo 或客戶之前,先讀程式碼。
- 有三個不是 Jev 原生的。
json-render(2026 年 1 月)、agent-desktop(2026 年 2 月)和prism-liquidity-agent(2026 年 6 月)都早於 Jev,並且不需它即可運行。 - 檢查授權條款。 大多數是 MIT,
json-render和agent-desktop是 Apache-2.0,而blink完全沒有授權檔案。 - 這裡沒有任何東西是官方的。 唯一由 TypeSafe 發布的整合是 agent skill,
typesafe-ai/skills。這份清單中的每個專案都是社群作品。 - 金融和實體展示都只是展示。
jev-trader預設使用 mock 模型和 dry-run 成交;jev-drone是模擬。不要把兩者解讀為關於實際效能的訊號。
你實際上該試哪一個
| 如果你想… | 從這裡開始 | 為什麼 |
|---|---|---|
| 了解決策模型是用來做什麼的 | jev-ultrafast |
7.1 秒的 Google Flights 展示讓這個分野顯而易見 |
| 今天就削減 agent 的 context 成本 | fast-jev-compaction 或 winnow |
安裝即可測量,無需架構變更 |
| 在五分鐘內把 Jev 導入你的 agent | typesafe-mcp |
一個指令就能接好三個客戶端 |
| 從 shell 或 CI 使用 Jev | semdecide |
真正的退出碼,無需黏合程式碼 |
| 阻止 agent 謊稱自己完成了 | Canny |
帳本加上拒絕接受聲明 |
| 控制每回合的模型花費 | jev-codex-router |
路由正是 Jev 回本的地方 |
| 看看平行問題被正確使用 | neo4jev |
一次呼叫同時使用 Choice 和 Noul,每一跳一次往返 |
FAQ
什麼是 Jev API?
Jev 是 TypeSafe AI 的 System One 模型。這個 API 只有一個端點,POST /v1/systemone:送出一個 state 加上一組具型別的問題,然後以 Choice、Score 和 Noul 答案的形式取回校準過的機率。它從不生成文字。
Jev 的模型 ID 和價格是什麼?
jev-1.13.0,並以 jev-latest 和 jev-preview 作為別名。定價為每十億輸入 token 42 美元——每 1M 為 0.042 美元——而輸出免費,因為沒有輸出 token。
這些專案是官方的 TypeSafe 專案嗎?
不是。全部二十個都是社群作品。唯一官方發布的整合是 TypeSafe agent skill,typesafe-ai/skills。
這些之中哪些不需要 Jev 金鑰就能使用?
json-render、agent-desktop 和 prism-liquidity-agent,因為它們不是 Jev 原生的。jev-trader 也能在 dry-run 模式下以其預設 mock 模型無金鑰運行。
我可以把 Jev 與 Claude Code 或 Codex 作為模型一起使用嗎? 不行。這兩個 CLI 都使用其供應商的傳輸格式,而 Jev 沒有 OpenAI 相容或 Anthropic 相容的端點。可行的是把 Jev 放進 agent 內部——作為 MCP 工具、hook 或 router——這正是第 2 組和第 3 組專案所做的事。
一次 Jev 呼叫實際上要花多少錢? 計費僅針對輸入,每 1M token 為 0.042 美元,而一個請求中的每個問題都會在同一輪中針對同一個 state 進行評估。問三十個問題的成本只比問一個略高,而不是三十倍——這個比例正是整個架構的重點。
Jev 在 APIMaster 上可用嗎?
可以,以 jev-latest 的形式,透過原生 POST https://apimaster.ai/v1/systemone 合約,每 1M 輸入 token 為 0.042 美元,輸出免費(一條啟用中的路由,於 2026 年 9 月 22 日檢查)。當某個步驟需要生成文字時,可搭配同一把金鑰上的文字模型使用。
來源與驗證
- 全部二十個專案的儲存庫中介資料、star 數、語言與授權條款 — GitHub API 與儲存庫 README,查核於 2026 年 9 月 22 日
- TypeSafe — Models — 模型 ID、別名、$42/Btok 定價、速率限制與上下文預算
- TypeSafe — API reference 與 Quick start — 端點、請求和回應結構
- TypeSafe — Jev 1.13 scope — TypeSafe 本身界定為範圍外的領域,以及各領域的建議模式
typesafe-ai/skills— 唯一官方發布的整合
APIMaster 的 jev-latest 路由與搭配的文字模型價格查核於 2026 年 9 月 22 日。專案狀態、star 數與定價會變動 — 在投入工作負載前,請在即時卡片與儲存庫上再次確認。
從金鑰開始
建立 APIMaster 帳戶,從 $1 起加值隨用隨付額度,並在主控台建立金鑰。將你的用戶端指向 https://apimaster.ai/v1,並將第一個請求傳送至 POST https://apimaster.ai/v1/systemone,模型使用 jev-latest — 每 1M 輸入 token $0.042,輸出免費,且同一把金鑰涵蓋你將搭配使用的 GPT、Claude、GLM、DeepSeek 與 Gemini 層級。在正式流量上線前,請查看 Jev 卡片確認即時可用性,並使用模型測試工具確認路由行為符合預期。
