跳轉到主要內容
OpenAI Decisions API
透過 MixRoute 的 OpenAI 相容 Decisions 介面,針對同一份輸入提出具名問題並取得結構化答案。模型使用 gpt-6-luna;此協定與 Jev System One 不同。

接入方式

POST https://api.mixroute.ai/v1/decisions 請求標頭使用 Authorization: Bearer $MIXROUTE_API_KEY 和 Content-Type: application/json。API Key 僅保存在伺服器端。模型和管道權限取決於帳戶;模型出現在列表中不代表所有介面均可用。
使用 input,不是 state;questions 是可帶 name 的陣列,不是以問題 ID 為鍵的物件。真假判斷用 predicate,不是 noul;分類用 choices,評分用 levels,不是 Jev 的 criteria。回應中的 answers 也是陣列。Jev 協定見 System One。

請求參數

問題欄位

答案型別

任何問題都可能傳回 type=refusal,其他問題仍可正常回應。依 name 或問題順序對應,先判斷 type,再讀取對應欄位,並明確處理拒答。信心分數和機率不保證判斷正確。

請求範例

呼叫前設定 MIXROUTE_API_KEY。範例只提交一次,不自動重試;用戶端逾時不代表伺服器端沒有執行推論。

回應範例

同步傳回 JSON 物件,不是 Chat Completions 的 choices 陣列,也不是需要輪詢的任務。機率和 token 用量會隨請求變化。

結構化與圖片輸入

user 訊息的 content 可包含 input_text(text)、input_image(image_url)、input_json(data)。JSON data 必須是物件或物件陣列;其中的鍵僅為待判斷的資料,不會觸發圖片擷取或建立訊息。JSON 輸入最多 32 層容器、10,000 個值、256 KiB 的緊湊 UTF-8 JSON。
圖片使用公開 HTTP(S) URL 或 Base64 data URL,不使用 file_id。detail 可選 auto、low、high、original。developer/system 訊息使用文字;assistant 訊息使用輸出文字或拒答項目。工具結果透過 call_id 與呼叫對應。此協定不接受檔案、音訊或項目參照。以上為協定格式,進階輸入的實際可用性取決於 MixRoute 路由。 將範例圖片網址替換為可公開存取的商品圖片或 Base64 data URL。

可選提示詞快取

共享 input 至少達到 1,024 tokens 才具備快取條件;questions 不屬於可重用的輸入前綴。預設使用隱含斷點;明確斷點在共享 input 的文字或圖片項目中設定 prompt_cache_breakpoint: {"mode": "explicit"}。prompt_cache_options.mode=explicit 且沒有明確斷點時不使用快取。問題 instructions 不支援快取斷點。不要將上游快取折扣或價格直接視為 MixRoute 費率。

錯誤與計費

先檢查 HTTP 狀態。閘道錯誤可能包含 error.message、error.type、error.code、error.param,其中 param 可能為空。排查時保留 x-oneapi-request-id,不記錄完整 API Key。
結合 usage 與目前模型廣場確認計費。不要假定 Responses 或 Chat Completions 的費率適用於 Decisions;實際費用取決於帳戶倍率和路由定價。