Verwendest du einen Programmieragenten? Kopiere diesen Prompt vor dem Start:
- 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
- Öffne das Phaseo-Dashboard.
- Erstelle einen Schlüssel unter Gateway -> Schlüssel.
- Kopiere ihn einmal und bewahre ihn sicher auf.
Behandle deinen API-Schlüssel wie ein Passwort. Gib ihn nicht in clientseitigem Code preis.
2. Textanfrage senden
Verwende für die erste AnfragePOST /v1/responses. Dieser Endpoint wird für neue Textgenerierung empfohlen.
Anfrage
Antwort
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
VerwendePOST /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.
PHASEO_API_KEY aus. Veröffentliche niemals einen Gateway-API-Schlüssel im Browsercode.
Die drei Fragetypen sind:
choicewählt eine Option aus einer Kriterien-Map und liefert Wahrscheinlichkeiten und Konfidenz.noulliefert eine Ja-/Nein-Wahrscheinlichkeit zwischen 0 und 1.scorebewertet ein geordnetes Kriterien-Array und liefert ein wahrscheinlichkeitsgewichtetes Ergebnis.
Anfrage
Antwort
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 denAuthorization-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.429oder5xx: Wiederhole die Anfrage mit exponentiellem Backoff.
5. Videofunktionen entwickeln
Die Videogenerierung läuft asynchron. Erstelle zuerst einen Job und frage anschließend den Status ab oder abonniere das Ergebnis.- Erstelle einen Job mit
POST /v1/videos. - Frage den Status mit
GET /v1/videos/{video_id}ab, bis der Job abgeschlossen ist. - Lade den Inhalt mit
GET /v1/videos/{video_id}/contentherunter.
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.