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 以便追查;欄位限制、多問題格式與回應細節請看完整參考。
用 JavaScript(Node.js)呼叫 Jev API
同一個請求改用伺服器端 Node.js 18 以上內建的 fetch。存成 classify.mjs,把 JEV_API_KEY 設為帳戶金鑰、JEV_IDEMPOTENCY_KEY 設為新的 8–100 字元值(例如 UUID),再執行 node classify.mjs。HTTP 失敗時,腳本會帶著錯誤代碼與訊息停止,不會讀取不完整的答案。
// Node.js 18+ (built-in fetch). Run on your server, never in the browser.
const apiKey = process.env.JEV_API_KEY?.trim();
const requestKey = process.env.JEV_IDEMPOTENCY_KEY?.trim();
if (!apiKey) throw new Error('JEV_API_KEY must not be empty');
if (!requestKey || requestKey.length < 8 || requestKey.length > 100) throw new Error('JEV_IDEMPOTENCY_KEY must be 8-100 characters');
const response = await fetch('https://jevapi.pro/api/v1/decisions', {
method: 'POST',
headers: {
Authorization: `Bearer ${apiKey}`,
'Content-Type': 'application/json',
'Idempotency-Key': requestKey,
},
body: JSON.stringify({
text: 'I was charged twice this month.',
instructions: 'Choose the responsible team.',
labels: ['billing', 'technical', 'account'],
threshold: 0.85,
}),
signal: AbortSignal.timeout(35_000),
});
const answer = await response.json();
if (!response.ok) throw new Error(`${response.status} ${answer.error?.code}: ${answer.error?.message}`);
console.log({ id: answer.id, choice: answer.choice, needsReview: answer.needsReview, confidence: answer.confidence });用 Python 呼叫 Jev API
先執行 python -m pip install requests,設定相同的兩個環境變數,把範例存成 classify.py 後執行 python classify.py。HTTP 失敗會在解析成功回應前停止,接著輸出判定 ID、分類與覆核旗標。
import json
import os
import requests
api_key = os.environ["JEV_API_KEY"].strip()
request_key = os.environ["JEV_IDEMPOTENCY_KEY"].strip()
if not api_key:
raise ValueError("JEV_API_KEY must not be empty")
if not 8 <= len(request_key) <= 100:
raise ValueError("JEV_IDEMPOTENCY_KEY must be 8-100 characters")
payload = {
"text": "I was charged twice for the same order.",
"instructions": "Choose the team responsible for this request.",
"labels": ["Billing", "Support", "Access"],
"threshold": 0.85,
}
response = requests.post(
"https://jevapi.pro/api/v1/decisions",
headers={
"Authorization": "Bearer " + api_key,
"Idempotency-Key": request_key,
},
json=payload,
timeout=(5, 30),
)
response.raise_for_status()
answer = response.json()
print(json.dumps({
"id": answer["id"],
"choice": answer["choice"],
"needsReview": answer["needsReview"],
}, ensure_ascii=False, indent=2))透過 REST 或 MCP 接入 Agent
保留 Agent 原本的主模型與工具權限。在需要選擇下一步時,由伺服器送出簡短任務、明確規則及允許的選項,例如繼續或覆核;收到結果後,先驗證 choice 屬於允許選項,再選擇處理路徑。
needsReview 為 true、信心缺失或請求失敗時,轉入覆核。模型預測不會授予退款、寄信或刪除資料的權限,這些規則必須由應用執行。本工作區也提供 https://jevapi.pro/api/mcp 與可下載的 Skill。請搭配本站金鑰使用,其他社群站的憑證不能混用。
{
"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 帳戶的餘額。
付款前先確認試用區能處理你的任務。正式接入前,驗證模糊輸入、缺失信心值、失效金鑰與供應商故障。先讓人檢查建議,再只對評估已支持的判定啟用自動化。
