Como Resolver o Erro 401 ‘API Key Inválida’ do Perplexity

Ao usar a API do Perplexity, você pode ver um erro 401 com a mensagem “API Key Invalid”. Esse erro significa que o servidor não conseguiu autenticar sua solicitação porque a chave da API está ausente, expirada ou incorreta. O problema geralmente ocorre após regenerar uma chave, copiá-la com espaços extras ou usar uma chave para um endpoint diferente. Este artigo explica por que o erro 401 acontece e fornece correções passo a passo para restaurar o acesso à API.

Por que a API do Perplexity retorna um erro 401

O código de status 401 significa “Não autorizado”. O servidor da API não consegue corresponder sua chave a uma conta ativa válida. A causa raiz é quase sempre um destes três cenários:

A chave foi regenerada ou revogada

Quando você regenera uma chave de API no painel do Perplexity, a chave antiga se torna inválida imediatamente. Se seu aplicativo ainda usa a chave antiga, toda solicitação falha com um erro 401. O mesmo acontece se você revogar manualmente uma chave ou se sua assinatura expirar.

A chave contém caracteres ocultos ou espaços extras

Copiar uma chave do painel pode incluir um espaço à direita, um caractere de nova linha ou caracteres Unicode invisíveis. O servidor vê uma string diferente da que seu aplicativo envia. Mesmo um caractere extra quebra a autenticação.

Endpoint ou método de API errado

A API do Perplexity espera que as solicitações sejam enviadas para https://api.perplexity.ai. Enviar a chave para uma URL base diferente ou usar um método HTTP que o endpoint não suporta também pode acionar um erro 401. Alguns usuários acidentalmente usam o endpoint da API do ChatGPT com uma chave do Perplexity, o que falha imediatamente.

Passos para corrigir o erro 401 de chave de API inválida

Siga estes passos em ordem. Teste após cada passo para isolar o problema.

Passo 1: Regere uma nova chave de API

1. Faça login no Painel da API do Perplexity
   Acesse https://www.perplexity.ai/settings/api e faça login com sua conta.
2. Navegue até Chaves de API
   Clique em API Keys na barra lateral esquerda. Você verá uma lista de chaves existentes.
3. Regere a chave
   Encontre a chave que você está usando atualmente e clique em Regenerate. Uma nova chave aparece. Copie-a imediatamente.
4. Copie sem caracteres extras
   Selecione o texto da chave com o mouse. Pressione Ctrl+C. Não clique fora da caixa de texto antes de copiar. Cole em um editor de texto simples como o Bloco de Notas para verificar se não há espaços extras ou novas linhas.

Passo 2: Atualize a chave no seu aplicativo

1. Localize onde a chave está armazenada
   Locais comuns: um arquivo .env, um arquivo de configuração JSON ou uma variável de ambiente em sua plataforma de hospedagem.
2. Substitua a chave antiga pela nova
   Cole a nova chave. Exclua quaisquer espaços extras antes ou depois da string da chave.
3. Salve o arquivo e reinicie seu aplicativo
   Se você usa variáveis de ambiente, reinicie o terminal ou o servidor do aplicativo. Um processo em execução pode armazenar em cache a chave antiga.
4. Teste a chamada da API
   Envie uma solicitação simples usando uma ferramenta como curl:
   curl -X POST https://api.perplexity.ai/chat/completions -H "Authorization: Bearer SUA_NOVA_CHAVE" -H "Content-Type: application/json" -d '{"model":"sonar-pro","messages":[{"role":"user","content":"Olá"}]}'
   Se a resposta não for um erro 401, a correção funcionou.

Passo 3: Verifique o endpoint da API e o formato da solicitação

1. Verifique a URL base
   Certifique-se de que seu código usa https://api.perplexity.ai e não um domínio diferente.
2. Confirme o método HTTP
   O endpoint de chat completions requer POST. Usar GET retorna um 401 ou 404.
3. Inclua o cabeçalho Authorization exatamente
   O cabeçalho deve ser Authorization: Bearer SUA_CHAVE. Não adicione Bearer duas vezes nem omita o espaço.

Se o erro 401 persistir após a correção principal

“API Key Invalid” aparece em uma ferramenta de terceiros

Algumas ferramentas como Zapier, n8n ou scripts personalizados armazenam em cache a chave da API. Mesmo após atualizar a chave nas configurações da ferramenta, a versão em cache ainda pode ser usada. Limpe o cache da ferramenta ou crie uma nova conexão do zero. Para o Zapier, exclua a conexão do Perplexity e adicione-a novamente com a nova chave.

Erro 401 apenas em algumas solicitações

Se algumas chamadas de API forem bem-sucedidas e outras falharem, você pode ter várias chaves de API em uso. Verifique todos os arquivos de configuração, variáveis de ambiente e strings codificadas. Pesquise em sua base de código por cada instância da chave antiga e substitua-a.

Problema de faturamento ou assinatura da conta

Uma assinatura expirada ou fatura não paga pode fazer com que a API rejeite solicitações mesmo com uma chave válida. Faça login no painel da API do Perplexity e verifique seu status de faturamento em Settings > Billing. Se sua conta estiver em atraso, renove a assinatura e regere a chave.

A chave contém um erro de digitação ou caractere errado

As chaves de API diferenciam maiúsculas de minúsculas. Compare a chave em seu aplicativo com a chave mostrada no painel caractere por caractere. Erros comuns incluem substituir 0 por O ou 1 por l. Use o botão de copiar no painel em vez de digitar a chave manualmente.

Formatos de chave da API do Perplexity e erros comuns

Item	Formato Correto	Erro Comum
Cabeçalho de autorização	Authorization: Bearer pplx-abc123...	Falta Bearer ou espaços extras
URL base da API	https://api.perplexity.ai	https://api.openai.com ou https://perplexity.ai
Prefixo da chave	pplx- seguido de 48 caracteres	Omitir pplx- ou adicionar traços extras
Método HTTP para chat	POST	GET ou PUT

Após corrigir a chave e o endpoint, o erro 401 deve parar. Se você ainda vir o erro, abra um ticket de suporte no painel da API do Perplexity. Inclua os cabeçalhos e o corpo exatos da solicitação que você está enviando. A equipe de suporte pode verificar se sua chave está ativa no lado deles. Para trabalhos contínuos com a API, armazene a chave em um cofre seguro e gire-a a cada 90 dias para evitar problemas de expiração.