Anbieter-Richtlinienreferenz

Referenzieren Sie die ShareAI-Provider-Felder, Standardwerte, Limits und Fehler, um Ausführungsanbieter in Inferenzanfragen auszuwählen.

Als Markdown anzeigen

Auf dieser Seite

Die optionale provider Objekt gehört auf die oberste Ebene der Inferenzanfrage, neben model. Ein leeres Objekt verwendet die Standardwerte. Es ist getrennt von Provider Remote Access und dessen Verwaltungscodes.

Feld	Typ	Verhalten
`only`	Array von Provider-Tags	Beschränken Sie die Ausführung auf diese Anbieter.
`ignore`	Array von Provider-Tags	Schließen Sie diese Anbieter aus, auch aus Fallbacks.
`order`	Array von Provider-Tags	Ordnen Sie diese Anbieter zuerst in der angegebenen Reihenfolge; dann Sortierung anwenden.
`allow_fallbacks`	boolean; Standardwert true	Andere berechtigte Anbieter zulassen. Mit false und einer nicht leeren Reihenfolge bleiben nur die aufgeführten Anbieter; ohne Reihenfolge bleibt nur der erstplatzierte Anbieter.
`networks`	Array	Beschränken Sie die Anbietertypen auf Community, Unternehmen und/oder ShareAI.
`sort`	string oder Objekt	Verwenden Sie Preis, Latenz oder Durchsatz, oder ein Objekt mit by und direction.

JSON

{
  "provider": {
    "ignore": [
      "PROVIDER_TO_EXCLUDE"
    ],
    "networks": [
      "company",
      "shareai"
    ],
    "sort": {
      "by": "throughput",
      "direction": "desc"
    },
    "allow_fallbacks": true
  }
}

Ersetzen Sie den Platzhalter durch ein echtes, kleingeschriebenes Provider-Tag oder entfernen Sie das ignore-Feld. Netzwerktypen wählen Infrastrukturkategorien; sie identifizieren keine Modell-Ersteller.

Standardwerte sortieren#

Sortieren	Standardrichtung	Explizite Umkehrung
`price`	`asc` — niedrigste zuerst	`desc` — höchste zuerst
`latency`	`asc` — kürzeste verstrichene Zeit zuerst	`desc` — längste zuerst
`throughput`	`desc` — die meisten Ausgabetoken pro Sekunde zuerst	`asc` — die wenigsten zuerst

Für ein Objekt setzen Sie by auf einen dieser Namen und direction zu asc oder desc. Siehe wie Messungen und Fallbacks funktionieren.

Validierung und Fehler#

Verwenden Sie JSON-Booleans und Arrays von kleingeschriebenen Provider-Tags. Senden Sie kein null für Provider oder Sortierung.
Nur die aufgeführten Felder werden akzeptiert; dies ist keine vollständige OpenRouter-Parameterimplementierung.
Die Richtlinie ist auf 8 KiB begrenzt. Die only-, ignore- und order-Listen akzeptieren jeweils maximal 100 Tags.
Ungültige Richtlinien geben HTTP 400 zurück. Verbotene Berechtigungsbereiche geben HTTP 403 zurück. Kein berechtigter verfügbarer Anbieter gibt HTTP 503 zurück.

Eine minimale Richtlinie#

JSON

{
  "provider": {
    "sort": "price"
  }
}

Wenn vollständig weggelassen, erfolgt die Anbieterauswahl standardmäßig auch nach deterministischer, preisaufsteigender Sortierung. Einschränkungen gelten immer vor der Sortierung.

Zuletzt aktualisiert am 16. September 2026