Zum Hauptinhalt springen
Setze eine Anbieter-ID und einen Doppelpunkt vor die Modell-ID, etwa baseten:thinking-machines/inkling-small, damit die Anfrage nur bei diesem Anbieter läuft, ohne Fallback zu einem anderen Anbieter. Das Format ist <provider-id>:<canonical-model-id>. Der erste Doppelpunkt trennt den Anbieter ab; Doppelpunkte nach dem Modell-Namespace bleiben Teil der Modell-ID. In google-ai-studio:google/gemma-4-26b-a4b:free ist der Anbieter google-ai-studio und das Modell google/gemma-4-26b-a4b:free. Wenn du einen Anbieter nur bevorzugst und einen Fallback möchtest, falls er ausfällt, verwende stattdessen die einfache Modell-ID mit den Routing- und Fallback-Steuerungen.

Eine Anfrage senden

Verwende die qualifizierte ID überall dort, wo der Endpunkt eine Modell-ID akzeptiert.

Was der Anbieter trotzdem erfüllen muss

Die Qualifizierung beschränkt das Routing auf einen Anbieter; sie überspringt keine andere Prüfung. Der Anbieter muss weiterhin:
  • das kanonische Modell am angeforderten Endpunkt bereitstellen, mit aktivierter Fähigkeit
  • die Einschränkungen von Arbeitsbereich, API-Schlüssel, Voreinstellung und Datenschutz erfüllen
  • die angeforderte Service-Stufe und die Parameter unterstützen
  • eine Preiskonfiguration haben
Schlägt eine Prüfung fehl, wird die Anfrage abgelehnt. Phaseo wählt nie stillschweigend einen anderen Anbieter.

Mit provider- oder routing-Feldern kombinieren

Die Qualifizierung und alle expliziten Routing-Felder müssen übereinstimmen. Ein passendes provider.only oder routing.only wird akzeptiert:
Eine Zulassungsliste, die andere Anbieter nennt, oder eine Ignorierliste, die den qualifizierten Anbieter enthält, wird mit provider_qualified_model_conflict abgelehnt:

Eine kostenlose Route bei einem Anbieter anfordern

Ein qualifiziertes :free-Modell wird nur akzeptiert, wenn dieser Anbieter eine geeignete kostenlose Route für das Modell und den Endpunkt hat. Ein kanonisches :free-Modell bedeutet nicht, dass jeder Anbieter des zugrunde liegenden Modells es kostenlos anbietet.
Die Preiskarte der Route darf nicht leer sein, und jede aktuelle Preisregel darauf muss als free gekennzeichnet sein und exakt null kosten. Fehlende, kostenpflichtige, gemischte oder negative Preise oder eine Regel mit Nullpreis ohne die Kennzeichnung free führen zur Ablehnung der Anfrage, bevor sie den Anbieter erreicht.

Anbieter-IDs und Aliase

Verwende eine Anbieter-ID aus dem Anbieterkatalog von Phaseo (siehe API-Anbieter). IDs werden in Kleinbuchstaben umgewandelt, und bekannte ältere oder Marken-Aliase werden der kanonischen ID zugeordnet: NovitaAI und novita-ai werden beide zu novita. Fehlerhafte und unbekannte IDs werden vor der Anbieterauswahl abgelehnt; sie werden nie als Teil des Modellnamens an den Upstream-Anbieter gesendet.

Validierungsfehler

Eine fehlerhafte qualifizierte ID gibt HTTP 400 mit dem Fehlercode validation_error zurück. reason und details[].keyword nennen die Ursache:
Andere Fehlerformen findest du unter Fehler und Debugging.
Zuletzt geändert am 5. November 2026