Skip to main content
Nutze dieses Tutorial für eine erfolgreiche Phaseo-Anfrage mit generiertem Text oder einer strukturierten Entscheidung und prüfe, wo die Antwort erscheint.
Verwendest du einen Programmieragenten? Kopiere diesen Prompt vor dem Start:
Du wirst:
  • einen API-Schlüssel erstellen
  • eine Textanfrage oder strukturierte Entscheidung senden
  • generierten Text oder typisierte Antworten lesen
  • wissen, was du bei einem Fehler zuerst prüfen solltest

1. API-Schlüssel erstellen

  1. Öffne das Phaseo-Dashboard.
  2. Erstelle einen Schlüssel unter Gateway -> Schlüssel.
  3. Kopiere ihn einmal und bewahre ihn sicher auf.
Verwende dieses Format:
Behandle deinen API-Schlüssel wie ein Passwort. Gib ihn nicht in clientseitigem Code preis.

2. Textanfrage senden

Verwende für die erste Anfrage POST /v1/responses. Dieser Endpoint wird für neue Textgenerierung empfohlen.

Anfrage

Antwort

Lies die Antwort des Assistenten bei direkten Responses-API-Aufrufen in output[].content[] an der Stelle mit type gleich output_text aus. Wenn du das Vercel AI SDK verwendest, lies die Antwort aus result.text aus.

3. Eine strukturierte Entscheidung treffen

Verwende POST /v1/decisions, wenn deine Anwendung typisierte Antworten statt generierten Texts benötigt. Phaseo bietet TypeSafes Jev 1.13 mit der Modell-ID typesafe/jev-1.13.0. Sende einen state-Wert und eine oder mehrere benannte Fragen; jede Antwort wird unter demselben Namen zurückgegeben.
Decisions ist eine Beta-Funktion und muss möglicherweise für den Workspace aktiviert werden. Jev 1.13 kostet $0.042 pro Million Eingabetokens; Ausgabetokens sind kostenlos.
Führe diese Beispiele auf deinem Server mit gesetztem PHASEO_API_KEY aus. Veröffentliche niemals einen Gateway-API-Schlüssel im Browsercode. Die drei Fragetypen sind:
  • choice wählt eine Option aus einer Kriterien-Map und liefert Wahrscheinlichkeiten und Konfidenz.
  • noul liefert eine Ja-/Nein-Wahrscheinlichkeit zwischen 0 und 1.
  • score bewertet ein geordnetes Kriterien-Array und liefert ein wahrscheinlichkeitsgewichtetes Ergebnis.
Du kannst verschiedene Fragetypen in einer Anfrage kombinieren.

Anfrage

Antwort

Lies den typisierten Wert der Antwort zur passenden Frage-ID, etwa answers.department.choice, answers.is_urgent.noul oder answers.customer_impact.score. Nutze confidence und probabilities für einen Anwendungsschwellenwert, statt allein anhand des Werts zu entscheiden. Siehe die Decisions-API-Referenz für vollständige Anfrage- und Antwortvorgaben sowie TypeSafes Jev-Modellreferenz für Modellverhalten und Anbieterlimits.

4. Erste Anfrage untersuchen

  • 401: Prüfe den API-Schlüssel und den Authorization-Header.
  • 400: Prüfe den Anfrageinhalt und die Modell-ID.
  • 402: Wechsle zu einem :free-Modell oder lade Guthaben auf, bevor du ein kostenpflichtiges Modell nutzt.
  • 429 oder 5xx: Wiederhole die Anfrage mit exponentiellem Backoff.
Nutze die Referenz zur Fehlerbehandlung, um das Problem schnell zu finden.

5. Videofunktionen entwickeln

Die Videogenerierung läuft asynchron. Erstelle zuerst einen Job und frage anschließend den Status ab oder abonniere das Ergebnis.
  1. Erstelle einen Job mit POST /v1/videos.
  2. Frage den Status mit GET /v1/videos/{video_id} ab, bis der Job abgeschlossen ist.
  3. Lade den Inhalt mit GET /v1/videos/{video_id}/content herunter.

6. Weiterentwickeln

Das Gateway integrieren

Integrationsmuster für den Produktivbetrieb und Auswahl des Endpoints.

API-Referenz

Vollständige Dokumentation zu Anfragen und Antworten für alle Endpoints.

Beispiele

Weitere vollständige Anfragebeispiele für häufige Abläufe.

Support

Erhalte Hilfe bei Debugging, Routing und Modellverhalten.
Zuletzt geändert am 2. Oktober 2026