供應商政策參考
參考 ShareAI 供應商欄位、預設值、限制同錯誤,以揀選推理請求嘅執行供應商。
喺呢頁面
可選嘅 provider 物件喺推理請求嘅頂層,並排於 model。一個空物件會使用預設值。佢同供應商遠程訪問同佢嘅管理憑證係分開嘅。
| 字段 | 類型 | 行為 |
|---|---|---|
only | 供應商標籤陣列 | 限制執行喺呢啲供應商。 |
ignore | 供應商標籤陣列 | 排除呢啲供應商,包括後備選項。 |
order | 供應商標籤陣列 | 按提供嘅順序優先排列呢啲供應商;然後應用排序。 |
allow_fallbacks | 布爾值;預設為 true | 允許其他符合條件嘅供應商。設為 false 同一個非空嘅排序列表時,只有列出嘅供應商會保留;冇排序時,只有排名第一嘅供應商會保留。 |
networks | 陣列 | 將供應商類型限制為社區、公司同/或 shareai。 |
sort | 字串或者物件 | 使用價格、延遲或者吞吐量,或者一個包含 by 同 direction 嘅物件。 |
JSON
{
"provider": {
"ignore": [
"PROVIDER_TO_EXCLUDE"
],
"networks": [
"company",
"shareai"
],
"sort": {
"by": "throughput",
"direction": "desc"
},
"allow_fallbacks": true
}
}
用真實嘅小寫供應商標籤取代占位符,或者移除 ignore 欄位。網絡類型選擇基礎設施類別;佢哋唔係用嚟識別模型創作者。
排序預設值#
| 排序 | 預設方向 | 明確反向 |
|---|---|---|
price | asc — 最低優先 | desc — 最高優先 |
latency | asc — 最短耗時優先 | desc — 最長優先 |
throughput | desc — 每秒最多輸出 token 優先 | asc — 最少優先 |
對於一個物件,設置 by 為呢啲名稱之一,並且 direction 到 asc 或 desc. 。睇 測量同後備選項嘅運作方式.
驗證同錯誤#
- 使用 JSON 布爾值同小寫供應商標籤嘅陣列。唔好為供應商或者排序發送 null。
- 只接受列出嘅欄位;呢個唔係完整嘅 OpenRouter 參數實現。
- 政策限制為 8 KiB。only、ignore 同 order 列表每個最多接受 100 個標籤。
- 無效政策會返回 HTTP 400。禁止嘅憑證範圍會返回 HTTP 403。無符合條件嘅可用供應商會返回 HTTP 503。
最簡政策#
JSON
{
"provider": {
"sort": "price"
}
}
當完全省略時,供應商選擇亦會預設為確定性嘅價格升序排序。約束條件永遠喺排序之前應用。
最後更新日期 2026年9月16日