Pular para o conteúdo principal
Crie uma chave de API, envie uma solicitação para POST /v1/responses e leia a resposta em output_text.

Comece com seu agente de código

Copie este prompt para o seu agente de código. Ele identifica a linguagem do seu projeto, instala o SDK, aponta o agente para a documentação da Phaseo, mantém sua chave fora do código e faz uma primeira solicitação. Se o seu projeto já usa a Phaseo, ele revisa essa configuração em vez de começar do zero. phaseo/free funciona sem créditos; troque por qualquer ID de modelo de texto em Modelos.

Prompt de configuração para o seu agente de código. Copie ou abra no Cursor.

Abrir no Cursor
Para configurar você mesmo, siga os passos abaixo.

1. Crie uma chave de API

Crie uma chave no painel, em Configurações -> Chaves de API, e exporte-a:
A chave é exibida uma única vez. Toda solicitação a envia como token bearer:
Trate sua chave de API como uma senha. Mantenha-a em código no servidor e nunca a inclua em um navegador ou aplicativo móvel.

Adicione créditos para modelos pagos

phaseo/free funciona sem créditos. Modelos pagos como openai/gpt-6-astra exigem saldo na carteira:
Com um cartão salvo, um proprietário ou administrador do espaço de trabalho confirma a cobrança por um link enviado por e-mail. Sem cartão salvo, o comando retorna um link de pagamento que um proprietário ou administrador abre para pagar, e o cartão fica salvo para as próximas recargas.

2. Envie uma solicitação de texto

POST /v1/responses é o endpoint recomendado para novos trabalhos com texto. Os exemplos usam openai/gpt-6-astra, um modelo pago. Para testar sem créditos, troque-o por phaseo/free, que escolhe um modelo gratuito disponível; veja Lance com o roteador gratuito. cURL e fetch não exigem nenhuma instalação. Para usar um SDK, instale-o primeiro:
Veja a página de instalação de TypeScript e Python para os requisitos de runtime e os outros SDKs.

3. Leia a resposta

Transmita a resposta

Use streaming para exibir a resposta à medida que ela é gerada. O text de cada evento response.output_text.delta contém apenas o texto novo, então este loop exibe a resposta uma única vez. Eventos de encerramento como response.output_text.done repetem texto que já foi transmitido. Veja Streaming para a lista completa de eventos.

4. Resolva problemas na primeira solicitação

A referência de erros lista todos os códigos de erro e o que fazer em cada caso.

Receba respostas tipadas em vez de texto

Quando o código precisa de um valor, e não de prosa, envie perguntas para POST /v1/decisions (Beta). Cada resposta volta tipada, com probabilidades, na mesma ordem das perguntas. Os tipos de pergunta são predicate (sim/não), choice (uma das suas opções) e score (um nível na sua escala).
A resposta (valores ilustrativos):
Leia answers[0].choice ou answers[1].probability e use confidence ou probabilities para definir seu próprio limite. A referência de Decisions lista todos os modelos de decisão, os limites e preços deles, a entrada de imagens e o formato antigo state, com mapas de perguntas nomeadas (noul, criteria), que ainda funciona e é exigido por alguns modelos.

Gere um vídeo

A geração de vídeo é assíncrona: crie uma tarefa, consulte o status dela e depois baixe o arquivo.
Para receber um webhook em vez de consultar o status, veja Tarefas assíncronas e webhooks.

Continue desenvolvendo

Integração com o Gateway

Escolha um endpoint e configure uma integração de produção.

Referência da API

Todos os campos de solicitação e de resposta de todos os endpoints.

Exemplos

Aplicativos iniciais para fluxos de trabalho comuns.

Suporte

Obtenha ajuda com depuração, roteamento e comportamento de modelos.
Última modificação em 16 de novembro de 2026