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.
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
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
input.4
Entwicklungsserver starten
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/modelsund/api/responses, und keine Anfrage enthältPHASEO_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/responsesund/api/modelseine 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: trueund leite die Ereignisse weiter; Streaming zeigt, welches Ereignis einen Responses-Stream beendet.