Pular para o conteúdo principal
Execute um pequeno aplicativo de chat em Next.js cujo código no navegador conversa apenas com as rotas do seu próprio servidor, para que sua chave de API da Phaseo nunca chegue ao navegador. Ao final, você terá uma página de chat local com um seletor de modelos preenchido por GET /v1/models e respostas vindas de POST /v1/responses. O exemplo é ilustrativo: as rotas não têm login nem limite de taxa, então qualquer pessoa que consiga acessá-las gasta a sua chave. Adicione primeiro as verificações de Antes de implantar. Para que um agente de programação crie o mesmo app do zero, cole este prompt:

Crie um aplicativo de chat web com Next.js sobre o Phaseo Gateway.

Abrir no Cursor

Como o exemplo é construído

O exemplo fica em examples/web-chat-nextjs:

Execute o exemplo

Você precisa do Node.js e de uma chave de API da Phaseo.
1

Instale

O exemplo inclui um package-lock.json, então o npm instala as versões testadas.
2

Crie o .env.local

O exemplo não tem .env.example. Crie o .env.local você mesmo:
.env.local
Aqui, NEXT_PUBLIC_GATEWAY_URL só é lido no servidor, mas o prefixo NEXT_PUBLIC_ o exporia ao código do navegador, então nunca coloque uma chave nele. Atribuição do aplicativo explica os dois cabeçalhos opcionais.
3

Corrija o segundo turno do chat

ChatClient.tsx envia o id da resposta anterior como previous_response_id. O Gateway não armazena respostas, então rejeita esse campo com 400 validation_error (palavra-chave unsupported_param) e a segunda mensagem falha. Em app/api/responses/route.ts, apague o bloco que copia previous_response_id para o payload:
app/api/responses/route.ts
Depois disso, cada turno é respondido de forma independente. Para manter o contexto, envie os turnos anteriores como um array de mensagens em input.
4

Inicie o servidor de desenvolvimento

Abra http://localhost:3000.

Verifique se funcionou

  • O seletor de modelos é preenchido com IDs de modelo.
  • Duas mensagens seguidas recebem uma resposta cada.
  • No painel de rede do navegador, as solicitações vão apenas para /api/models e /api/responses, e nenhuma solicitação carrega PHASEO_API_KEY.
  • Um ID de modelo inválido mostra a mensagem de erro do Gateway em vez de uma resposta em branco.
  • As solicitações aparecem em Configurações → Uso → Registros com o título do app que você definiu.

Antes de implantar

  • Autentique as rotas. Exija um usuário conectado em /api/responses e /api/models, ou use a bancada de trabalho OAuth para que cada usuário gaste os próprios créditos.
  • Use uma lista de modelos permitidos. A rota encaminha qualquer string model vinda do navegador. Verifique-a contra uma lista fixa no servidor.
  • Limite a entrada e a taxa. Limite o tamanho da entrada e as solicitações por usuário, e defina um limite de gasto na chave.
  • Use streaming se precisar. Defina stream: true e encaminhe os eventos; Transmissão mostra qual evento encerra um stream da API Responses.
Para um script de backend em vez de uma UI, comece pelo aplicativo de smoke test REST com Node ou pela CLI de gateway em Python.
Última modificação em 5 de novembro de 2026