提供者政策参考
参考 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 — 每秒输出最多的标记优先 | 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 日