Chave da API Perplexity Revogada Sem Aviso: Causa e Recuperação

Você está usando a API do Perplexity em seu aplicativo ou script e, de repente, as requisições falham com erro 401 ou 403. A chave que funcionava minutos atrás agora retorna falha de autenticação. Isso geralmente acontece sem qualquer e-mail de aviso ou notificação no painel do Perplexity. Este artigo explica as causas técnicas por trás da revogação silenciosa da chave da API e fornece etapas de recuperação detalhadas para restaurar seu acesso rapidamente.

Por que o Perplexity Revoga Chaves de API Sem Aviso

O Perplexity nem sempre envia um e-mail quando uma chave de API é revogada. A revogação ocorre no nível do servidor, e a próxima chamada de API retorna um erro. As causas raiz mais comuns são:

Limite de Taxa ou Cota Excedido

O Perplexity impõe limites de taxa por minuto e cotas mensais de tokens nas chaves de API. Se seu aplicativo envia requisições mais rápido que o limite ou usa todos os tokens antes do fim do ciclo de faturamento, a chave é revogada temporária ou permanentemente. A API retorna um erro 429 Too Many Requests antes da revogação, mas se o pico for extremo, o sistema pode pular o aviso e revogar a chave diretamente.

Falha de Pagamento ou Problema de Faturamento

Se você usa um plano pré-pago e seu cartão de crédito expira, é recusado ou o saldo da sua conta fica negativo, o Perplexity revoga todas as chaves de API ativas. Isso é uma medida de segurança para evitar uso não pago. O sistema nem sempre envia uma notificação; a chave simplesmente para de funcionar.

Violação da Política de Segurança

O Perplexity monitora padrões de uso da API para abuso. Se sua chave for usada de vários endereços IP em rápida sucessão, ou se as requisições contiverem conteúdo proibido (por exemplo, discurso de ódio, atividade ilegal), a chave é revogada sem aviso prévio. Isso protege a plataforma contra uso indevido.

Suspensão ou Exclusão da Conta

Se sua conta do Perplexity for suspensa devido a violações dos Termos de Serviço ou se você acidentalmente excluir a conta, todas as chaves de API associadas são revogadas. A exclusão da conta é irreversível, mas a suspensão pode ser contestada.

Etapas para Diagnosticar e Recuperar uma Chave de API Revogada

Siga estas etapas em ordem. Não pule nenhuma — cada uma descarta uma causa diferente.

Passo 1: Verifique o Status da Chave de API no Painel

1. Faça login no Painel da API Perplexity
   Acesse perplexity.ai/settings/api. Faça login com a conta proprietária da chave revogada.
2. Navegue até a seção Chaves de API
   No menu à esquerda, clique em API Keys. Uma tabela lista todas as chaves com uma coluna de status. Uma chave revogada exibe um selo vermelho com o texto Revoked.
3. Clique na chave revogada para ver detalhes
   A página de detalhes mostra o motivo da revogação, se o Perplexity o registrou. Motivos comuns incluem Limite de taxa excedido, Problema de faturamento ou Violação de segurança.

Passo 2: Revise o Uso e a Cota

1. Vá para Uso e Limites
   No painel, clique em Usage & Limits no menu à esquerda.
2. Verifique o período de faturamento atual
   Observe a barra Tokens Used. Se estiver em 100% ou acima do limite do seu plano, você excedeu sua cota. A chave pode ter sido revogada para evitar cobranças de excesso.
3. Verifique o gráfico de limite de taxa
   Abaixo da barra de cota, um gráfico mostra requisições por minuto. Se você vir um pico acima do limite do seu plano, isso explica a revogação.

Passo 3: Verifique o Status de Faturamento

1. Vá para Faturamento
   Clique em Billing no menu à esquerda.
2. Verifique o método de pagamento
   Em Payment Method, confirme se o cartão registrado não expirou. Se expirou, clique em Update Payment Method e insira um novo cartão.
3. Verifique o saldo pendente
   Se o Current Balance mostrar um número negativo, você deve dinheiro. Pague o saldo clicando em Add Funds ou Pay Now.

Passo 4: Crie uma Nova Chave de API

1. Volte para Chaves de API
   Clique em API Keys no menu à esquerda.
2. Clique em Criar Nova Chave
   Um botão no topo da tabela. Uma caixa de diálogo aparece solicitando um nome e permissões para a chave.
3. Defina as permissões da chave
   Selecione os modelos e endpoints que esta chave pode acessar. Para a maioria dos casos de uso, deixe todas as caixas marcadas.
4. Copie a chave imediatamente
   Após a criação, um pop-up mostra o valor da chave uma vez. Copie-o e armazene-o com segurança. Se você fechar o pop-up, a chave fica oculta para sempre — você deve excluí-la e recriá-la.
5. Atualize seu aplicativo
   Substitua a chave antiga revogada pela nova chave em seu código, variáveis de ambiente ou arquivo de configuração. Reinicie seu aplicativo.

Passo 5: Entre em Contato com o Suporte se a Chave Foi Revogada Devido a uma Violação de Segurança

1. Abra um ticket de suporte
   Acesse perplexity.ai/support. Clique em Contact Support.
2. Explique a situação
   Informe que sua chave de API foi revogada sem aviso. Inclua o nome da chave (não o valor completo) e o timestamp de quando parou de funcionar. Não mencione conteúdo proibido — se suspeitar de uma violação, peça esclarecimentos.
3. Aguarde uma resposta
   O suporte do Perplexity geralmente responde em 24 a 48 horas. Se a revogação foi um erro, eles reativarão a chave ou instruirão você a criar uma nova.

Se a Chave Ainda Estiver Revogada Após Seguir Estas Etapas

Chave Aparece como Ativa, mas a API Retorna 401

A chave pode estar ativa, mas a requisição está sem o cabeçalho Authorization ou usa o formato errado. Certifique-se de que seu cabeçalho HTTP seja exatamente: Authorization: Bearer SUA_CHAVE_API. Não adicione aspas ou espaços extras. Se você estiver usando um SDK, atualize para a versão mais recente.

Chave Foi Revogada e Recriada, mas a Chave Antiga Ainda Está no Código

Você pode ter atualizado a chave no painel, mas esqueceu de atualizar a variável de ambiente ou o arquivo de configuração. Verifique todos os locais onde a chave está armazenada: arquivos .env, segredos de CI/CD, gerenciadores de segredos de provedores de nuvem e strings codificadas no código-fonte.

Conta Foi Excluída

Se você não conseguir fazer login no Painel da API Perplexity, sua conta pode ter sido excluída. Isso é irreversível. Você deve criar uma nova conta e uma nova chave de API. Para evitar isso, ative a autenticação de dois fatores e evite compartilhar suas credenciais de login.

Revogação de Chave da API Perplexity: Planos Gratuito, Pro e Enterprise

Item	Plano Gratuito	Plano Pro	Plano Enterprise
Acesso à API incluído	Não	Sim, com cota de tokens	Sim, com cota personalizada
Limite mensal de tokens	N/A (sem API)	5 milhões de tokens	Personalizado (negociado)
Limite de taxa (requisições/min)	N/A	60 RPM	Personalizado (maior)
Notificação de revogação	N/A	E-mail apenas para problemas de faturamento	E-mail e alerta no painel
Tempo de resposta do suporte	N/A	24 a 48 horas	2 a 4 horas

Se você está no plano gratuito, não pode usar a API. Atualize para o plano Pro ou Enterprise para obter acesso à API. Os planos Enterprise incluem suporte prioritário e alertas proativos antes do esgotamento da cota, reduzindo a chance de revogação silenciosa.

Agora você conhece as quatro principais causas de revogação silenciosa de chave de API e as etapas exatas para diagnosticar e recuperar cada uma. Comece verificando o status da chave de API no painel, depois confirme seu uso e faturamento. Criar uma nova chave é o método de recuperação mais rápido quando a causa é cota ou faturamento. Para violações de segurança, entre em contato com o suporte informando o nome da chave e o timestamp. Para minimizar futuras revogações, configure alertas de uso no painel e monitore seu consumo de tokens semanalmente.