Jev 是什麼？何時適合使用 API？
Jev 是 TypeSafe 的判定模型：提供界線明確的問題與上下文，讀取有型別的答案。例如把客服訊息分到帳務、技術或帳號存取，後續動作仍由你的應用決定。
TypeSafe 將它稱為 System One 模型。一般聊天模型可以撰寫說明或規劃任務；此 API 適合程式需要明確分類、分數或是非判斷的地方。它不會瀏覽網頁、執行工具，也不取代 Agent 的規劃模型。請用自己的樣本比較，不能預設某模型永遠更快、更便宜或更準確。
先試一筆判定，再建立金鑰
在試用區選擇客服、潛在客戶或意見範例，編輯訊息與標籤。查看示意結果不會呼叫模型；執行真實判定是另一個操作，受試用額度及服務可用性限制。
使用去識別化範例，提供足以區分標籤的資訊，並保留另一組樣本做評估。單筆結果看起來合理，不代表整體準確率已通過驗證。
如何取得 Jev API 金鑰
登入本工作區、選擇有有效 API 存取權的方案，再到工作台建立具名金鑰。顯示秘密值時立即存入伺服器的憑證儲存區。TypeSafe、OpenRouter 或其他社群網站的金鑰，不能當成本服務的帳號金鑰。
以 Authorization: Bearer 標頭傳送金鑰，單靠網站登入 cookie 不能授權 REST。不要把金鑰放進瀏覽器 JavaScript、公開倉庫、提示詞或 Skill 檔案。不再使用或已外洩的金鑰，應在工作台撤銷。
送出入門請求，讀懂回應
上方 curl 範例呼叫 POST https://jevapi.pro/api/v1/decisions。把 YOUR_API_KEY 換成伺服器金鑰，提供 text、instructions、不重複的 labels 與 threshold。每筆新判定使用新的 Idempotency-Key；只在取回或重試完全相同的請求時重用它。
新判定成功會回傳 HTTP 201。choice 是選中的標籤，needsReview 表示是否需要覆核。供應商未提供信心值時，confidence 可能是 null，不能把缺值當成確定答案。保留 id 以便追查；欄位限制、多問題格式與回應細節請看完整參考。
透過 REST 接入 Agent
保留 Agent 原本的主模型與工具權限。在需要選擇下一步時，由伺服器送出簡短任務、明確規則及允許的選項，例如繼續或覆核；收到結果後，先驗證 choice 屬於允許選項，再選擇處理路徑。
needsReview 為 true、信心缺失或請求失敗時，轉入覆核。模型預測不會授予退款、寄信或刪除資料的權限，這些規則必須由應用執行。本工作區提供 REST 文件；其他網站的 MCP 網址或 jev_* 工具名稱並非本站端點。
{
"text": "Task: read a public API guide and summarize its supported request fields. No account changes or external messages are requested.",
"instructions": "Choose review if the task is unclear or could change external state. Otherwise choose proceed. This classification never grants permission to execute a tool.",
"labels": [
"proceed",
"review"
],
"threshold": 0.9
}處理錯誤，避免重複執行
400 先修正輸入；401/403 檢查金鑰與存取權；402 檢查點數。429 若附 Retry-After 就遵守等待時間，並限制重試次數。供應商故障應進入可見的備援路徑，不要無限重試。
相同金鑰與內容可取回已完成結果，不會再次扣除判定點數。內容不同卻重用金鑰會收到 409；已記錄失敗的請求重播也會回傳 409，修正原因後才用新金鑰重新嘗試。網路逾時而結果不明時，先用原金鑰確認。
Jev API 價格與下一步
Jev API Pro 販售預付存取期間與判定點數，並非模型供應商直接按 token 計價的服務。即時價格、點數、存取期限與結帳條件均在方案頁。在此購買，不會增加 TypeSafe 或 OpenRouter 帳戶的餘額。
付款前先確認試用區能處理你的任務。正式接入前，驗證模糊輸入、缺失信心值、失效金鑰與供應商故障。先讓人檢查建議，再只對評估已支持的判定啟用自動化。