/api/v1/routing-preferences。
認證
需要具有billing API 密鑰作用域的 Bearer 令牌,並且需要有權訪問該密鑰(調用者擁有該密鑰,或通過其所在的活躍組織獲得訪問權限)。
GET
讀取該密鑰的規則以及已解析的綁定狀態。響應
active: true—— 這些規則當前正驅動該密鑰的補全請求。active: false—— 該密鑰繼承了默認設置(或綁定到了某個共享偏好設置);規則仍可編輯,但在保存之前或共享綁定被清除之前不會生效。shared_binding—— 當該密鑰綁定到某個共享偏好設置(而非其隱藏行)時會填充此字段。此時應將共享規則渲染為只讀,並提供一個”在此密鑰上覆蓋”按鈕。
PUT
替換按密鑰的規則/示例/覆蓋項。該路由會自動查找或創建隱藏的偏好設置,並確保綁定指向它。object[]
最多 50 條規則。結構與
routing-preferences 相同。object[]
最多 30 個少樣本(few-shot)示例。
object
按模式設置的置信度下限覆蓋項。
DELETE
清除按密鑰的規則:刪除綁定,使解析級聯回退到組織默認 → 用戶默認 → 無,並刪除隱藏的偏好設置行。指向非隱藏(共享)偏好設置的現有綁定不受影響。錯誤
400 routing_preference_invalid—— 校驗失敗(例如出現供應商名稱、正則表達式無法編譯等)。404 not_found—— 密鑰不存在、已被吊銷,或調用者無權訪問。
