Zum Hauptinhalt springen
Führe eine kleine Next.js-Chat-App aus, deren Browser-Code nur mit deinen eigenen Server-Routen spricht, sodass dein Phaseo-API-Schlüssel nie den Browser erreicht. Am Ende hast du eine lokale Chat-Seite mit einer Modellauswahl, die aus GET /v1/models befüllt wird, und Antworten von POST /v1/responses. Das Beispiel dient der Veranschaulichung: Seine Routen haben weder Anmeldung noch Ratenbegrenzung, sodass jeder, der sie erreicht, deinen Schlüssel verbraucht. Ergänze zuerst die Prüfungen aus Vor dem Deployment. Damit ein Coding-Agent dieselbe App von Grund auf baut, füge diesen Prompt ein:

Erstelle eine Next.js-Web-Chat-App auf Basis von Phaseo Gateway.

In Cursor öffnen

So ist das Beispiel aufgebaut

Das Beispiel liegt in examples/web-chat-nextjs:

Beispiel ausführen

Du brauchst Node.js und einen Phaseo-API-Schlüssel.
1

Installieren

Das Beispiel enthält eine package-lock.json, daher installiert npm die getesteten Versionen.
2

.env.local anlegen

Das Beispiel hat keine .env.example. Lege .env.local selbst an:
.env.local
NEXT_PUBLIC_GATEWAY_URL wird hier nur auf dem Server gelesen, aber das Präfix NEXT_PUBLIC_ würde den Wert für Browser-Code offenlegen, also schreibe niemals einen Schlüssel hinein. App-Zuordnung erklärt die beiden optionalen Header.
3

Den zweiten Chat-Zug reparieren

ChatClient.tsx sendet die id der vorherigen Antwort als previous_response_id. Das Gateway speichert keine Antworten und lehnt dieses Feld daher mit 400 validation_error (Schlüsselwort unsupported_param) ab, und die zweite Nachricht schlägt fehl. Lösche in app/api/responses/route.ts den Block, der previous_response_id in den Payload kopiert:
app/api/responses/route.ts
Jeder Zug wird dann für sich beantwortet. Um den Kontext zu behalten, sende die früheren Züge als Array von Nachrichten in input.
4

Entwicklungsserver starten

Öffne http://localhost:3000.

Prüfen, ob es funktioniert hat

  • Die Modellauswahl füllt sich mit Modell-IDs.
  • Zwei Nachrichten hintereinander erhalten jeweils eine Antwort.
  • Im Netzwerk-Panel des Browsers gehen Anfragen nur an /api/models und /api/responses, und keine Anfrage enthält PHASEO_API_KEY.
  • Eine ungültige Modell-ID zeigt die Fehlermeldung des Gateways statt einer leeren Antwort.
  • Die Anfragen erscheinen unter Einstellungen → Nutzung → Protokolle mit dem App-Titel, den du gesetzt hast.

Vor dem Deployment

  • Routen authentifizieren. Verlange auf /api/responses und /api/models eine angemeldete Person, oder nutze die OAuth-Workbench, damit jede Person ihr eigenes Guthaben verbraucht.
  • Modelle per Zulassungsliste beschränken. Die Route leitet jeden model-String aus dem Browser weiter. Prüfe ihn auf dem Server gegen eine feste Liste.
  • Eingabe und Rate begrenzen. Begrenze die Eingabelänge und die Anfragen pro Person und setze ein Ausgabenlimit für den Schlüssel.
  • Streamen, wenn du es brauchst. Setze stream: true und leite die Ereignisse weiter; Streaming zeigt, welches Ereignis einen Responses-Stream beendet.
Für ein Backend-Skript statt einer UI beginne mit der Node-REST-Smoke-App oder der Python-Gateway-CLI.
Zuletzt geändert am 5. November 2026