Jev API 文件

請求契約：一份標籤清單

以 Authorization: Bearer YOUR_API_KEY、Content-Type: application/json 與 8–100 字元的 Idempotency-Key，將 POST 送到 /api/v1/decisions。內容包含 text（3–6,000 字元）、instructions（3–1,500 字元）、labels（2–12 個不重複、各佔一行且不超過 60 字元的選項）與 threshold（0.5–1，預設 0.85）。

金鑰屬於具備有效存取期間的帳戶，請在工作空間面板建立。每次完成的請求消耗 1 點判定點數。匿名試做使用獨立額度，且不會暴露你的供應商憑證。

內容只能是其中一種形狀：單一標籤判定送 instructions 與 labels，型別化判定送 questions，不要同時送出；同一把 Idempotency-Key 只用於同一個邏輯請求。

在試做區執行同一個請求 · 什麼是 Jev AI · OpenRouter 判定 API 參考

請求契約：型別化問題

改送 questions 就能對同一段文字提出最多四個型別化問題。每個問題有 id（1–32 字元：小寫字母、數字或底線，以字母開頭，且在同一次請求中不重複）、型別、instructions（3–1,500 字元）與準則：choice 需要 2–12 個準則標籤，noul 需要正好 true 與 false，score 需要 2–7 個、各不超過 80 字元的有序等級。準則的說明行可以留空，但不得超過 300 字元或換行。

若內容把 questions 與 instructions 或 labels 混在一起，會以 400 ambiguous_input 拒絕；超過四個問題或 id 重複也一樣。兩種形狀都是一次請求 1 點：問得多只改變回答的內容，不改變價格。

{
  "text": "按下付款後結帳頁面變成空白，我試過兩個瀏覽器。",
  "questions": [
    {"id": "team", "type": "choice", "instructions": "這個案件應由哪個團隊負責？", "criteria": {"billing": "帳務或退款問題。", "technical": "錯誤或異常行為。", "account": "登入、權限或個人資料。"}},
    {"id": "is_bug", "type": "noul", "instructions": "來訊者是否回報產品缺陷？", "criteria": {"true": "描述了損壞或異常的行為。", "false": "提出問題或功能需求。"}},
    {"id": "urgency", "type": "score", "instructions": "這個案件需要多快回應？", "criteria": ["可以等", "本週內", "工作被卡住"]}
  ],
  "threshold": 0.85
}

LLM 評審：可稽核的型別化規則 · 批次分類與匯出

回應契約

新的判定以 201 回傳 choice、confidence、probabilities、needsReview、model、id 與 latencyMs。model 指出回答的上游 Jev 模型；本部署請求的是 typesafe/jev-1.13。帳戶請求還會回傳剩餘點數，冪等重播則會加上 replayed: true。

型別化請求會多一個 answers：每個問題 id 一個項目，型別與你要求的一致。choice 帶標籤、信心與機率；noul 帶一個 0 到 1 的機率且沒有信心，因為供應商不提供；score 帶它在等級上的位置、信心、機率，以及供應商提供時的 legend。最上層的 choice、confidence 與 probabilities 對應第一個問題——noul 會以 true 或 false 呈現，信心為 null、機率表為空——只要任一答案需要覆核，needsReview 就是 true。

needsReview 是本服務依你的門檻所做的判讀。choice 或 score 在信心缺失或低於門檻時低於門檻；noul 直接以機率衡量，因此門檻 0.85 時 0.80 需要覆核。機率只檢查範圍與是否落在允許值上：不要求總和為 1、不要求最大值對應答案，缺少的機率表會回傳 {}。模型失敗是錯誤回應，絕不會變成預設標籤。

{
  "answers": {
    "team": { "type": "choice", "choice": "technical", "confidence": 0.88, "probabilities": { "billing": 0.03, "technical": 0.88, "account": 0.09 }, "needsReview": false },
    "is_bug": { "type": "noul", "noul": 0.93, "needsReview": false },
    "urgency": { "type": "score", "score": 2, "confidence": 0.80, "probabilities": { "0": 0.03, "1": 0.17, "2": 0.80 }, "needsReview": true }
  },
  "choice": "technical",
  "confidence": 0.88,
  "probabilities": { "billing": 0.03, "technical": 0.88, "account": 0.09 },
  "needsReview": true,
  "model": "typesafe/jev-1.13",
  "id": "6f2c1a4e-9d7b-4c11-8f3a-2b5e9c0d1a77",
  "latencyMs": 1180,
  "credits": 19
}

限額與點數規則

安全重試

每個邏輯請求使用一把新金鑰；連線結果不明時，重複使用同一把。重播已完成的請求會回傳既有結果，不再扣點，並標示 replayed: true。以同一把金鑰送出不同內容會回傳 409。請求失敗後，請先排除原因，再使用新的金鑰。

限額與點數規則