GET /v1/models y respuestas de POST /v1/responses.
El ejemplo es ilustrativo: sus rutas no tienen inicio de sesión ni límite de solicitudes, así que cualquiera que pueda acceder a ellas gasta tu clave. Añade primero las comprobaciones de Antes de desplegarla.
Para que un agente de programación cree la misma aplicación desde cero, pega este prompt:
Crea una aplicación de chat web con Next.js sobre Phaseo Gateway.
Cómo está construido el ejemplo
El ejemplo está en examples/web-chat-nextjs:Ejecútalo
Necesitas Node.js y una clave de API de Phaseo.1
Instala
package-lock.json, así que npm instala las versiones probadas.2
Crea .env.local
El ejemplo no tiene Aquí
.env.example. Crea .env.local tú mismo:.env.local
NEXT_PUBLIC_GATEWAY_URL solo se lee en el servidor, pero el prefijo NEXT_PUBLIC_ la expondría al código del navegador, así que nunca pongas una clave en ella. Atribución de aplicaciones explica las dos cabeceras opcionales.3
Corrige el segundo turno del chat
ChatClient.tsx envía el id de la respuesta anterior como previous_response_id. El Gateway no guarda respuestas, así que rechaza ese campo con 400 validation_error (palabra clave unsupported_param) y el segundo mensaje falla. En app/api/responses/route.ts, elimina el bloque que copia previous_response_id en el payload:app/api/responses/route.ts
input.4
Inicia el servidor de desarrollo
http://localhost:3000.Comprueba que funciona
- El selector de modelos se rellena con ID de modelo.
- Dos mensajes seguidos reciben cada uno una respuesta.
- En el panel de red del navegador, las solicitudes van solo a
/api/modelsy/api/responses, y ninguna llevaPHASEO_API_KEY. - Un ID de modelo incorrecto muestra el mensaje de error del Gateway en lugar de una respuesta en blanco.
- Las solicitudes aparecen en Ajustes → Uso → Registros con el título de aplicación que configuraste.
Antes de desplegarla
- Autentica las rutas. Exige un usuario con sesión iniciada en
/api/responsesy/api/models, o usa el banco de trabajo OAuth para que cada usuario gaste sus propios créditos. - Limita los modelos a una lista permitida. La ruta reenvía cualquier cadena
modelque llegue del navegador. Compruébala en el servidor contra una lista fija. - Limita la entrada y la frecuencia. Limita la longitud de la entrada y las solicitudes por usuario, y fija un límite de gasto en la clave.
- Usa streaming si lo necesitas. Pon
stream: truey reenvía los eventos; Streaming muestra qué evento termina un stream de Responses.