unhardcoded
參考

API 參考文件

OpenAI 相容的 completions 端點、dry-run 輔助工具及欄位 schema 查詢。

這是一個與 OpenAI 相容的 completions 端點,附帶 dry-run 輔助工具和欄位 schema 查詢。在請求本體中攜帶 policy_irflow_ir;推論透過託管方設定的供應商 API 金鑰執行。

驗證授權

每個請求均需攜帶 Authorization: Bearer <key>。託管方金鑰用於識別您的工作區及其追蹤紀錄,而非供應商帳戶。供應商的 API 金鑰(OpenAI、Anthropic、Gemini 等)在託管方側設定;unhardcoded 使用您自己的帳戶進行路由,不轉售權杖、不對推論費用加價,也不向您收取模型呼叫費用。

端點

POST/v1/chat/completions
OpenAI 相容的 completions 端點。在請求本體中攜帶 policy_irflow_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)與 modelmessages 同級,位於請求本體頂層;若兩者同時存在,flow_ir 優先生效。附加策略或工作流程後,路由由其驅動,model 僅作為追蹤紀錄標籤使用。若均未提供,則 model 字串選擇路由,例如 profile:cheapflow:<id>,並備援至託管方的預設設定。

curl
$ 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"]], …]
    }'
← 返回文件