Crie uma conta e uma chave
Cadastre-se, entenda o que pertence a um espaço de trabalho e crie uma chave de API que fique fora do seu código.
Cadastre-se em phaseo.app com Google, GitHub, GitLab ou e-mail e senha. Toda conta começa com um espaço de trabalho pessoal, que basta para um projeto pequeno.
O espaço de trabalho é a unidade dona das coisas. Ele guarda suas chaves de API, configurações de roteamento, predefinições, guardrails e quem tem acesso de administração. As solicitações pagas usam o saldo de créditos do espaço de trabalho. Depois do seu primeiro depósito de créditos, você pode adicionar mais espaços de trabalho, por exemplo um por produto ou por ambiente. Espaços de trabalho extras não mudam os seus preços.
Crie uma chave em Configurações → Chaves de API e selecione Criar chave. Escolha o espaço de trabalho, dê um nome à chave e escolha uma predefinição:
- Desenvolvimento: um limite diário de gastos baixo para apps locais e protótipos.
- Produção: sem limites predefinidos. Adicione limites depois, se precisar.
- CI: um limite de solicitações para testes, avaliações e tarefas de lançamento.
- Ambiente de testes: um limite rigoroso para demonstrações, testes e experimentos compartilhados.
As chaves podem ter limites diários, semanais ou mensais de solicitações e de gastos. Quando um limite é atingido, as solicitações com essa chave retornam 429 com key_limit_exceeded.
A chave é exibida uma única vez. Copie-a e guarde-a em uma variável de ambiente:
export PHASEO_API_KEY="phaseo_v1_sk_..."
Trate-a como uma senha. Leia-a de PHASEO_API_KEY em código no servidor. Nunca a coloque no seu código, em um repositório, em um navegador ou app móvel, nem em um chat com uma pessoa ou um agente. Use uma chave por app e por ambiente, para poder trocar uma sem quebrar as outras, e exclua as chaves que você não usa mais.
Confira o que você aprendeu
Onde a sua chave de API do Phaseo deve ficar?
Aplique
Você está criando um protótipo que chama um modelo pago em um loop. Você tem medo de que um bug gere uma conta alta durante a noite. O que dá para fazer ao criar a chave?
Mostrar a respostaOcultar a resposta
Escolha a predefinição Desenvolvimento ou Ambiente de testes, que definem um limite de gastos baixo, ou defina um limite diário de gastos na chave. Se o loop atingir o limite, as solicitações retornam 429 com key_limit_exceeded em vez de gastar mais. Use uma chave separada para produção.
Resumo
Links relacionados
Verificado em 17 de novembro de 2026