Autenticação

Tipos de chave

Chaves de API do Gateway chamam endpoints de modelos, provedores e geração disponíveis no seu workspace.

Chaves de API de gerenciamento chamam APIs administrativas. Veja Chaves de API de gerenciamento.

Rotacione uma chave atualizando o aplicativo para usar a substituta antes de invalidar a credencial antiga. Veja o endpoint de rotação de chaves.

As chaves seguem o formato phaseo_v1_sk_<kid>_<secret>. Trate-as como senhas e evite armazená-las em código executado no cliente ou em repositórios públicos.

Você pode chamar modelos :free sem depositar créditos. Modelos pagos exigem saldo disponível na carteira.

Formato do cabeçalho

Inclua a chave no cabeçalho Authorization de todas as solicitações:

Authorization: Bearer phaseo_v1_sk_<kid>_<secret>

A maioria dos clientes HTTP permite configurar isso uma única vez. Por exemplo, com fetch:

const response = await fetch("https://api.phaseo.app/v1/chat/completions", {
	method: "POST",
	headers: {
		Authorization: `Bearer ${process.env.PHASEO_API_KEY}`,
		"Content-Type": "application/json",
	},
	body: JSON.stringify({
		model: "openai/gpt-5-nano",
		messages: [
			{ role: "system", content: "You are a helpful assistant." },
			{
				role: "user",
				content: "Summarize the drawbacks to AI.",
			},
		],
	}),
});

Lista de verificação para gerenciar chaves

Prática	Por que isso importa
Use uma chave por app	Assim, você pode alterná-la sem afetar outros serviços.
Armazene as chaves com segurança	Gerenciadores de segredos evitam a exposição acidental em logs ou ferramentas de monitoramento de erros.
Monitore o uso	O painel mostra métricas por chave para você detectar anomalias rapidamente.
Remova chaves sem uso	Excluir chaves antigas reduz a superfície de possíveis abusos.

Erros comuns de autenticação

401 Não autorizado: a chave está ausente, é inválida ou pertence a um workspace desativado.

403 Proibido: a chave existe, mas não pode acessar o provedor ou modelo solicitado.

429 Too Many Requests: a chave ou o espaço de trabalho excedeu um limite. Veja Limites de solicitações.

Erros 5xx: tente novamente com espera exponencial e entre em contato com o suporte se o problema persistir.

Visão geral

Modelos e roteamento

Recursos

Integrações

Espaços de trabalho e acesso

Confiabilidade e operações

Plataforma e pesquisa

Guias de migração

Comunidade

Tipos de chave

Formato do cabeçalho

Lista de verificação para gerenciar chaves

Erros comuns de autenticação

​Tipos de chave

​Formato do cabeçalho

​Lista de verificação para gerenciar chaves

​Erros comuns de autenticação

Tipos de chave

Formato do cabeçalho

Lista de verificação para gerenciar chaves

Erros comuns de autenticação