Lektion 1 von 4 · 6 Minuten

Was Phaseo ist

Phaseo ist ein Gateway: eine API und ein Schlüssel vor vielen Modellen und den Anbietern, die sie hosten.

Phaseo ist ein AI-Gateway. Du sendest jede Anfrage an eine API, https://api.phaseo.app/v1, mit einem Schlüssel. Phaseo gibt jede Anfrage an einen Anbieter weiter, der sie bedienen kann, und rechnet sie über deinen Workspace ab. Du kannst die Form der Responses-, Chat-Completions- oder Messages-API nutzen, je nachdem, welche deine App schon spricht.

Modelle und Anbieter sind zwei verschiedene Dinge. Ein Modell ist das System, das die Antwort schreibt. Ein Anbieter hostet das Modell und legt Preis, Geschwindigkeit, Verfügbarkeit und unterstützte Parameter fest. Ein Modell kann mehrere Anbieter haben.

Eine Modell-ID benennt das Modell, nicht den Anbieter. IDs sehen aus wie openai/gpt-6-astra oder anthropic/claude-sonnet-5.5: zuerst das Labor, dann das Modell. phaseo/free wählt ein verfügbares kostenloses Modell und funktioniert ohne Credits. Wenn du genau einen bestimmten Anbieter brauchst, kannst du ihn vor die ID setzen, zum Beispiel baseten:thinking-machines/inkling-small.

So wird eine Anfrage geroutet:

  1. Phaseo behält nur die Anbieter, die deine Workspace-Einstellungen und deine Anfrage erlauben.
  2. Es reiht sie. Der Standardmodus balanced wägt Preis, Geschwindigkeit und Zuverlässigkeit ab.
  3. Es ruft den besten Anbieter auf. Schlägt dieser fehl, versucht es den nächsten.
  4. Schlagen alle Anbieter mit einem wiederholbaren Fehler fehl und hast du in models Fallback-Modelle angegeben, versucht es das nächste Modell.

Fallbacks garantieren keinen Erfolg. Deine App sollte 429- und 5xx-Fehler deshalb trotzdem mit Backoff wiederholen. Noch etwas: Der öffentliche Katalog listet auch Modelle, die sich noch nicht aufrufen lassen. Prüfe, dass ein Modell Auf Gateway aktiv ist, bevor du seine ID verwendest.

Prüfe dein Verständnis

Du rufst ein Modell auf, das drei Anbieter hosten, und der bestplatzierte Anbieter gibt einen Fehler zurück. Was macht Phaseo als Nächstes?

Wende es an

Eine Kollegin hat auf der Seite „Modelle“ von Phaseo ein Modell gefunden und seine ID in eine Anfrage kopiert. Die Anfrage schlägt fehl, aber die Modellseite sieht gut aus. Was ist der wahrscheinlichste Grund, und wie prüfst du ihn?

Antwort anzeigen

Der Katalog listet mehr Modelle, als das Gateway aufrufen kann. Das Modell ist vielleicht „Demnächst verfügbar“ oder „Inaktiv“. Auf der Seite „Modelle“ zeigt der Filter „Gateway-Status“ standardmäßig Modelle, die auf dem Gateway aktiv sind, und GET /v1/models gibt nur Modelle zurück, die du aufrufen kannst. Wähle ein Modell, das auf dem Gateway aktiv ist.

Das Wichtigste

Du wählst das Modell; Phaseo wählt einen Anbieter, der es hostet, und weicht auf einen anderen aus, wenn einer fehlschlägt.

Weiterführende Links

Dein Fortschritt wird in diesem Browser gespeichert.

Zuletzt geprüft am 17. November 2026