Gruppen-Pinning
Ein Modell auf bestimmte Anbietergruppen festlegen statt auf das günstigste Routing.
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 aktive Gruppe.
Das Festlegen überschreibt das pro Modell. Du wählst, welche Gruppen es nutzen darf und in welcher Reihenfolge sie versucht werden, und die Abrechnung richtet sich nach deren Preisen.
Jede Modellseite listet unter Group Pricing jede Gruppe mit Eingabe- und Ausgabepreis. Das Rabattabzeichen in der Modellliste bezieht sich auf die günstigste Gruppe.

Öffne API-Schlüssel, einen Schlüssel erstellen oder bearbeiten und die Gruppenauswahl öffnen. Ein Modell suchen, anklicken und eine oder mehrere Gruppen ankreuzen. Unberührte Modelle bleiben auf auto.

Festgelegte Modelle stehen oben, mit einem Abzeichen für die Anzahl ihrer Gruppen. Clear all setzt den Schlüssel auf auto zurück. Die Schlüsselliste zeigt festgelegte Schlüssel als auto +N.
Statt Anbieter einzeln anzuhaken, ziehen Sie den Preisbereich mit zwei Reglern, um nur über Anbieter zu leiten, deren Rate darin liegt. Da die Auswahl über den Preis statt über den Namen läuft, werden neue Anbieter im Bereich automatisch berücksichtigt.

Preisbereich und festgelegte Lanes werden vereinigt: Der Bereich deckt die günstigen Anbieter ab, und eine Festlegung behält einen bestimmten teuren Anbieter als Ausweichlösung, auch wenn er außerhalb des Bereichs liegt. Mit Günstigste zuerst wird diese Ausweichlösung erst erreicht, wenn alles Günstigere ausfällt; mit Meine Reihenfolge bestimmst du ihren Platz selbst.
Automatisch setzt ein Modell auf die normale Kette vom günstigsten Anbieter zurück. Bereich und Anheftungen bleiben gespeichert, aber inaktiv, sodass beim Ausschalten genau die vorherige Konfiguration zurückkehrt.

Unter der Lane-Liste legt Ausweichreihenfolge fest, in welcher Reihenfolge die gewählten Lanes versucht werden. Günstigste zuerst ist die Voreinstellung: Die Lanes gehen vom niedrigsten zum höchsten Preis, und die Liste zeigt diese Reihenfolge, ohne dass du sie ändern kannst.

Wechsle zu Meine Reihenfolge, um die gewählten Lanes in eine beliebige Abfolge zu ziehen. Anfragen versuchen zuerst die oberste Lane und gehen nur weiter nach unten, wenn sie fehlschlägt, so kannst du einen Anbieter, dem du vertraust, einem günstigeren vorziehen. Nach Preis sortieren setzt die Liste auf günstigste zuerst zurück. Eine ausgefallene Lane behält ihren Platz und wird übersprungen, bis sie wieder läuft.

Ist ein Preisbereich gesetzt, folgen Lanes, die der Bereich hinzufügt, die du aber nicht gewählt hast, nach deiner Liste, die günstigste zuerst. Ein Anbieter, der später in den Bereich fällt, landet ebenfalls dort.
Ein festgelegtes Modell läuft nur über seine festgelegten Gruppen und weicht bei Fehlern aus, in der Reihenfolge, die unter Ausweichreihenfolge eingestellt ist. Die Gruppe, die die Anfrage bedient, bestimmt den abgerechneten Preis.
Kombiniere ein Pinning mit einer Beobachtung, um von Preisänderungen oder Ausfällen der Gruppen zu erfahren, siehe Benachrichtigungen
Um eine einzelne Anfrage festzulegen, ohne den Schlüssel zu ändern, einen Header X-Group mit dem exakten Gruppennamen senden. Er überschreibt die Festlegung des Schlüssels und das auto-Routing. Namen aus Group Pricing kopieren.
curl https://api.test.wanmo.ai/v1/chat/completions \
-H "Authorization: Bearer $UNOROUTER_API_KEY" \
-H "Content-Type: application/json" \
-H "X-Group: glm-new-relay-glm-5.2" \
-d '{
"model": "glm-5.2",
"messages": [{ "role": "user", "content": "Hello" }]
}'Der Header muss eine Gruppe nennen, die der Schlüssel nutzen darf, sonst wird die Anfrage abgelehnt. Nicht festgelegte Modelle bleiben beim günstigsten Routing.
Fällt jede festgelegte Gruppe aus, während andere Anbieter das Modell weiter bedienen, scheitern Anfragen mit einem eigenen Fehler statt mit einer allgemeinen Auslastungsmeldung:
{
"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"
}
}Die Festlegung erweitern oder entfernen oder es später erneut versuchen. Das Modell selbst läuft.