Passer au contenu principal
Exécutez une petite application de chat Next.js dont le code du navigateur ne communique qu’avec vos propres routes serveur, pour que votre clé API Phaseo n’atteigne jamais le navigateur. À la fin, vous avez une page de chat locale avec un sélecteur de modèle alimenté par GET /v1/models et des réponses venant de POST /v1/responses. L’exemple est illustratif : ses routes n’ont ni connexion ni limite de débit, donc toute personne qui peut les atteindre dépense votre clé. Ajoutez d’abord les vérifications de Avant de le déployer. Pour qu’un agent de code crée la même application de zéro, collez ce prompt :

Créez une application de chat web Next.js avec Phaseo Gateway.

Ouvrir dans Cursor

Comment l’exemple est construit

L’exemple se trouve dans examples/web-chat-nextjs :

L’exécuter

Il vous faut Node.js et une clé API Phaseo.
1

Installer

L’exemple fournit un package-lock.json : npm installe donc les versions testées.
2

Créer .env.local

L’exemple n’a pas de .env.example. Créez vous-même .env.local :
.env.local
Ici, NEXT_PUBLIC_GATEWAY_URL n’est lu que sur le serveur, mais le préfixe NEXT_PUBLIC_ l’exposerait au code du navigateur : n’y mettez donc jamais de clé. Attribution des applications explique les deux en-têtes facultatifs.
3

Corriger le deuxième tour de chat

ChatClient.tsx envoie l’id de la réponse précédente dans previous_response_id. Le Gateway ne stocke pas les réponses : il rejette donc ce champ avec 400 validation_error (mot-clé unsupported_param) et le deuxième message échoue. Dans app/api/responses/route.ts, supprimez le bloc qui copie previous_response_id dans la charge utile :
app/api/responses/route.ts
Chaque tour reçoit alors une réponse indépendante. Pour conserver le contexte, envoyez les tours précédents sous forme de tableau de messages dans input.
4

Démarrer le serveur de développement

Ouvrez http://localhost:3000.

Vérifier que ça fonctionne

  • Le sélecteur de modèle se remplit d’identifiants de modèle.
  • Deux messages consécutifs reçoivent chacun une réponse.
  • Dans le panneau réseau du navigateur, les requêtes vont uniquement vers /api/models et /api/responses, et aucune ne contient PHASEO_API_KEY.
  • Un identifiant de modèle incorrect affiche le message d’erreur du Gateway au lieu d’une réponse vide.
  • Les requêtes apparaissent dans Paramètres → Utilisation → Journaux avec le titre d’application que vous avez défini.

Avant de le déployer

  • Authentifiez les routes. Exigez un utilisateur connecté sur /api/responses et /api/models, ou utilisez le workbench OAuth pour que chaque utilisateur dépense ses propres crédits.
  • Limitez les modèles à une liste autorisée. La route transmet n’importe quelle chaîne model venant du navigateur. Vérifiez-la sur le serveur par rapport à une liste fixe.
  • Plafonnez la saisie et le débit. Limitez la longueur de la saisie et le nombre de requêtes par utilisateur, et définissez une limite de dépenses sur la clé.
  • Utilisez le streaming si nécessaire. Définissez stream: true et transmettez les événements ; Streaming indique quel événement termine un flux Responses.
Pour un script backend plutôt qu’une interface, partez de l’application de test REST Node ou de la CLI Gateway en Python.
Dernière modification le 5 novembre 2026