API 參考文件
OpenAI 相容的 completions 端點、dry-run 輔助工具及欄位 schema 查詢。
這是一個與 OpenAI 相容的 completions 端點,附帶 dry-run 輔助工具和欄位 schema 查詢。在請求本體中攜帶 policy_ir 或 flow_ir;推論透過託管方設定的供應商 API 金鑰執行。
驗證授權
每個請求均需攜帶 Authorization: Bearer <key>。託管方金鑰用於識別您的工作區及其追蹤紀錄,而非供應商帳戶。供應商的 API 金鑰(OpenAI、Anthropic、Gemini 等)在託管方側設定;unhardcoded 使用您自己的帳戶進行路由,不轉售權杖、不對推論費用加價,也不向您收取模型呼叫費用。
端點
POST/v1/chat/completions
OpenAI 相容的 completions 端點。在請求本體中攜帶
policy_ir 或 flow_ir,其餘部分與標準請求格式相同。路由器在即時目錄中解析模型,並將決策寫入追蹤紀錄。POST/x/rankdry-run
在不執行推論的情況下,回傳候選模型排名及各模型的評定結果。在消耗任何權杖之前,預先確認哪些模型通過篩選條件及其原因。
POST/x/policy/normalizedry-run
接受一個
policy_ir,回傳其規範化形式、內容 fingerprint 及語法 version。無需執行即可識別並快取一個 term。POST/x/flow/normalizedry-run
接受並識別一個
flow_ir,驗證其有界圖及每個節點的策略,使格式錯誤的工作流程在執行中途失敗之前就能快速報錯。GET/x/fields
回傳即時欄位詞彙表,包含核心欄位及該託管實例所註冊的延伸欄位——策略透過
cmp/is 進行篩選、透過 field 進行評分的依據。這是有效欄位名稱的權威來源。請求本體
policy_ir(或 flow_ir)與 model、messages 同級,位於請求本體頂層;若兩者同時存在,flow_ir 優先生效。附加策略或工作流程後,路由由其驅動,model 僅作為追蹤紀錄標籤使用。若均未提供,則 model 字串選擇路由,例如 profile:cheap 或 flow:<id>,並備援至託管方的預設設定。
$ curl https://<your-host>/v1/chat/completions \
-H "Authorization: Bearer $UNHARDCODED_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "policy:support",
"messages": [{ "role": "user", "content": "…" }],
"policy_ir": ["policy", ["and", ["meets_req"]], …]
}'