在消耗點數前先攔截格式與欄位錯誤
串接分類 API 最常見的錯誤往往發生在模型執行之前:重複標籤、漏帶 Idempotency-Key、標籤超過 60 字元,或同時傳送 labels 與 questions 觸發 400 ambiguous_input。先在前端完成契約檢查,能確保第一次正式呼叫就順利通過。
你可隨時切換單一標籤清單(2 至 12 個選項)或型別化多問題模式(單次請求最多組合 4 個 choice、noul 是非題或 score 等級題)。兩種模式每次成功判定皆只消耗 1 點。
單一標籤與型別化多問題模式對照
若流程只需決定單一負責佇列,使用平面標籤陣列最精簡;若同一則訊息需同時判斷是否違規、嚴重程度與分派部門,合併為單次多問題請求可省下多次網路往返延遲。
| 請求模式 | 值域限制 | 回傳關鍵欄位 | 點數消耗 |
|---|---|---|---|
| 單一標籤清單 | 2–12 個不重複標籤(上限 60 字) | choice, confidence, probabilities, needsReview | 1 點 |
| 型別 choice | 每題 2–12 個具名準則 | answers[id].choice, confidence, needsReview | 1 點(最多 4 題) |
| 型別 noul | 明確定義 true 與 false 條件 | answers[id].probability (0–1), needsReview | 1 點(最多 4 題) |
| 型別 score | 2–7 個有序評分等級 | answers[id].level, confidence, needsReview | 1 點(最多 4 題) |
從結構驗證無縫銜接正式 API 金鑰
確認 JSON 結構無誤後,可先到 Playground 免費試跑,或直接選購 $29 單次加值包(1,800 點不過期)與 $39 Builder 方案(30 天 3,500 點),建立可隨時撤銷的伺服器端金鑰。
JSON 結構產生器常見問題
在這個工具調整結構會扣除帳號點數嗎?
不會。欄位驗證、201 模擬回應與程式碼產生皆在瀏覽器本地運算,不會發送 API 請求也不消耗點數。
同一個請求可以混用 choice、noul 與 score 嗎?
可以。questions 陣列最多可放 4 個不同型別的問題,整筆請求完成僅計 1 點,任一題低於門檻即會標記 needsReview。
