Zum Hauptinhalt springen
Erstelle einen API-Schlüssel, sende eine Anfrage an POST /v1/responses und lies die Antwort aus output_text.

Mit deinem Coding-Agenten starten

Kopiere diesen Prompt in deinen Coding-Agenten. Er erkennt die Sprache deines Projekts, installiert das SDK, verweist den Agenten auf die Phaseo-Dokumentation, hält deinen Schlüssel aus dem Code heraus und sendet eine erste Anfrage. Nutzt dein Projekt Phaseo bereits, prüft er stattdessen die bestehende Einrichtung. phaseo/free funktioniert ohne Guthaben; setze eine beliebige Textmodell-ID aus Modelle ein.

Einrichtungs-Prompt für deinen Coding-Agenten. Kopiere ihn oder öffne ihn in Cursor.

In Cursor öffnen
Wenn du es selbst einrichten möchtest, folge den Schritten unten.

1. API-Schlüssel erstellen

Erstelle einen Schlüssel im Dashboard unter Einstellungen -> API-Schlüssel und exportiere ihn:
Der Schlüssel wird nur einmal angezeigt. Jede Anfrage sendet ihn als Bearer-Token:
Behandle deinen API-Schlüssel wie ein Passwort. Halte ihn in serverseitigem Code und liefere ihn nie an einen Browser oder eine mobile App aus.

Guthaben für kostenpflichtige Modelle aufladen

phaseo/free funktioniert ohne Guthaben. Kostenpflichtige Modelle wie openai/gpt-6-astra brauchen ein Wallet-Guthaben:
Mit gespeicherter Karte bestätigt ein Inhaber oder Admin des Workspace die Zahlung über einen Link per E-Mail. Ohne gespeicherte Karte gibt der Befehl einen Zahlungslink zurück, den ein Inhaber oder Admin zum Bezahlen öffnet, und die Karte wird für spätere Aufladungen gespeichert.

2. Textanfrage senden

POST /v1/responses ist der empfohlene Endpunkt für neue Textanwendungen. Die Beispiele verwenden openai/gpt-6-astra, ein kostenpflichtiges Modell. Um ohne Guthaben zu testen, ersetze es durch phaseo/free, das ein verfügbares kostenloses Modell wählt; siehe Mit dem kostenlosen Router starten. Für cURL und fetch musst du nichts installieren. Ein SDK installierst du zuerst:
Laufzeitanforderungen und die anderen SDKs findest du auf der Installationsseite für TypeScript und Python.

3. Antwort lesen

Antwort streamen

Streame, um die Antwort auszugeben, während sie generiert wird. Das Feld text jedes response.output_text.delta-Events enthält nur den neuen Text, daher gibt diese Schleife die Antwort genau einmal aus. Abschließende Events wie response.output_text.done wiederholen bereits gestreamten Text. Die vollständige Liste der Events findest du unter Streaming.

4. Fehler bei der ersten Anfrage beheben

Die Fehlerreferenz listet jeden Fehlercode und was dagegen zu tun ist.

Typisierte Antworten statt Text erhalten

Wenn dein Code einen Wert statt Fließtext braucht, sende Fragen an POST /v1/decisions (Beta). Jede Antwort kommt typisiert und mit Wahrscheinlichkeiten zurück, in derselben Reihenfolge wie die Fragen. Die Fragetypen sind predicate (ja/nein), choice (eine deiner Optionen) und score (eine Stufe auf deiner Skala).
Die Antwort (Werte zur Veranschaulichung):
Lies answers[0].choice oder answers[1].probability und lege mit confidence oder probabilities deinen eigenen Schwellenwert fest. Die Decisions-Referenz listet jedes Entscheidungsmodell mit seinen Limits und Preisen, die Bildeingabe und das ältere state-Format mit benannten Fragen-Maps (noul, criteria), das weiterhin funktioniert und von manchen Modellen vorausgesetzt wird.

Ein Video generieren

Die Videogenerierung ist asynchron: Erstelle einen Job, frage seinen Status ab und lade dann die Datei herunter.
Wie du statt der Abfrage einen Webhook erhältst, steht unter Asynchrone Jobs und Webhooks.

Weiterentwickeln

Das Gateway integrieren

Wähle einen Endpunkt und richte eine Produktionsintegration ein.

API-Referenz

Jedes Anfrage- und Antwortfeld für jeden Endpunkt.

Beispiele

Starteranwendungen für gängige Arbeitsabläufe.

Support

Hilfe beim Debuggen, beim Routing und zum Modellverhalten.
Zuletzt geändert am 16. November 2026