Gruppen-Pinning

Jedes Modell wird von einer oder mehreren Anbietergruppen bedient, jede mit eigenem Preis. Standardmäßig nutzt ein Schlüssel auto: Jede Anfrage geht an die günstigste gerade verfügbare Gruppe.

Pinning überschreibt das pro Modell: Du wählst genau, welche Gruppen es nutzen darf, und die Abrechnung ist an deren Tarife gebunden. Nützlich, wenn du die Qualität oder Region eines bestimmten Anbieters brauchst oder einen Tarif, der sich nicht bewegen darf.

Die Detailseite jedes Modells listet unter Group Pricing jede Gruppe mit ihrem Eingabe- und Ausgabepreis; das Rabatt-Badge in der Modellliste spiegelt immer die günstigste Gruppe.

Öffne API-Schlüssel, erstelle oder bearbeite einen Schlüssel und öffne den Gruppenwähler. Suche ein Modell, klicke es an und hake eine oder mehrere Anbietergruppen ab, sortiert günstigste zuerst mit ihrem Tarif-Multiplikator. Unberührte Modelle bleiben auf auto.

Gepinnte Modelle schwimmen mit einem Badge nach oben, das zeigt, auf wie viele Gruppen sie fixiert sind; „Alle löschen“ setzt den Schlüssel auf volles auto zurück. Die Schlüsselliste zeigt gepinnte Schlüssel als auto +N.

Ein gepinntes Modell routet nur innerhalb seiner gepinnten Gruppen: Die günstigste wird zuerst versucht, bei Fehlern oder Ausfall geht es automatisch zur nächsten. Abgerechnet wird der Tarif der Gruppe, die die Anfrage tatsächlich bedient hat.

Kombiniere ein Pinning mit einer Beobachtung, um von Preisänderungen oder Ausfällen der Gruppen zu erfahren, siehe Benachrichtigungen

Du kannst auch pro Anfrage binden, ohne den Schlüssel zu ändern: sende einen X-Group-Header mit dem genauen Gruppennamen. Er gewinnt über die gespeicherte Bindung des Schlüssels und über das automatische Routing für diese eine Anfrage. Kopiere einen Gruppennamen aus der Gruppenpreis-Tabelle eines Modells.

curl https://api.unorouter.com/v1/chat/completions \
  -H "Authorization: Bearer $UNOROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -H "X-Group: glm-new-pol-glm-5.2" \
  -d '{
    "model": "glm-5.2",
    "messages": [{ "role": "user", "content": "Hello" }]
  }'

Der Header muss eine Gruppe sein, die der Schlüssel verwenden darf, sonst wird die Anfrage abgelehnt. Nicht gebundene Modelle behalten das Routing zum günstigsten verfügbaren Anbieter, wenn kein Header gesendet wird.

Sind alle gepinnten Gruppen eines Modells ausgefallen, während andere Anbieter es weiter bedienen, schlagen Anfragen mit einem gezielten Fehler statt einer generischen Meldung fehl:

{
  "error": {
    "message": "Your pinned provider groups for model \"glm-5.2\" are currently unavailable, but the model is still served by other providers. Edit this key's group override, or try again later.",
    "type": "new_api_error",
    "code": "get_channel_failed"
  }
}

Erweitere oder entferne das Pinning am Schlüssel oder versuche es später erneut. Das Modell selbst läuft weiter.