Para usar o Perplexity programaticamente em seus próprios aplicativos, scripts ou ferramentas de terceiros, você precisa de uma chave de API. Esta chave atua como um token único que autentica suas solicitações à API do Perplexity. Sem ela, você não pode acessar os endpoints de busca, chat ou conclusão.
O processo requer uma assinatura paga do Perplexity Pro. Contas gratuitas não têm acesso à API. Depois de assinar, você pode gerar a chave na página de configurações da sua conta. Este artigo mostra as etapas exatas para criar e copiar sua primeira chave de API do Perplexity.
Você também aprenderá como definir a chave em ambientes de desenvolvimento comuns e como evitar erros de segurança que podem expor sua chave.
Principais Conclusões: Gerando Sua Primeira Chave de API do Perplexity
- Assinatura Perplexity Pro necessária: Apenas assinantes Pro podem criar e usar chaves de API.
- Configurações > API > Gerar Chave: O caminho exato do menu para criar uma nova chave.
- Variável de ambiente PERPLEXITY_API_KEY: Melhor prática para armazenar a chave com segurança no desenvolvimento.
O Que Você Precisa Antes de Gerar uma Chave de API do Perplexity
A API do Perplexity não está disponível no plano gratuito. Você deve ter uma assinatura ativa do Perplexity Pro. Em 2025, o Pro custa US$ 20 por mês e inclui consultas de busca ilimitadas, acesso ao GPT-4, Claude e outros modelos, além de acesso à API.
Você também precisa de uma conta no Perplexity. Se não tiver uma, cadastre-se em perplexity.ai com um e-mail ou conta do Google. Depois, assine o Pro na página Configurações > Assinatura.
Após assinar, a seção de API fica visível nas configurações da sua conta. Nenhuma configuração adicional ou ferramentas de desenvolvimento são necessárias no seu computador para gerar a chave.
Passos para Gerar Sua Chave de API do Perplexity
- Faça login no Perplexity
Abra seu navegador e acesse perplexity.ai. Entre com a conta que possui uma assinatura Pro ativa. - Abra as Configurações
Clique na sua foto de perfil ou iniciais no canto superior direito. Selecione Configurações no menu suspenso. - Navegue até a seção de API
Na barra lateral esquerda, clique em API. Esta página mostra suas chaves de API existentes e permite criar novas. - Gere uma nova chave
Clique no botão Gerar Chave. Uma caixa de diálogo aparece pedindo para nomear a chave. Digite um nome descritivo como “Desenvolvimento” ou “MeuApp-v1”. - Copie a chave imediatamente
Após clicar em Gerar, a nova chave aparece como uma longa string alfanumérica. Clique no ícone de cópia ao lado dela. O Perplexity não mostra a chave completa novamente depois que você sai desta página. Armazene-a em um gerenciador de senhas seguro ou em um arquivo de variáveis de ambiente.
Usando a Chave em um Ambiente de Desenvolvimento
A maneira mais segura de usar sua chave de API é através de uma variável de ambiente. No macOS ou Linux, adicione esta linha ao seu arquivo de perfil do shell, por exemplo .zshrc ou .bashrc:
export PERPLEXITY_API_KEY="sua-chave-aqui"
No Windows, defina-a em Propriedades do Sistema > Variáveis de Ambiente ou execute este comando no Prompt de Comando:
setx PERPLEXITY_API_KEY "sua-chave-aqui"
Em Python, você pode acessá-la com os.getenv('PERPLEXITY_API_KEY'). Nunca codifique a chave diretamente nos arquivos de código-fonte.
Erros Comuns e Avisos de Segurança
Perdi Minha Chave de API Depois de Fechar a Aba do Navegador
O Perplexity não armazena a chave completa em texto simples na página de configurações após a geração. Se você não a copiou, não pode recuperá-la. Você deve gerar uma nova chave e salvá-la imediatamente em um local seguro, como um gerenciador de senhas.
Minha Chave de API Foi Exposta no GitHub
Se você acidentalmente enviou sua chave para um repositório público, revogue-a imediatamente. Vá para Configurações > API, encontre a chave e clique em Revogar ou Excluir. Gere uma nova chave e adicione regras de .env ou .gitignore para evitar futuros vazamentos.
Chamadas de API Retornam 401 Não Autorizado
Um erro 401 significa que a chave de API está ausente, expirada ou inválida. Verifique se sua variável de ambiente está definida corretamente. Se você regenerou a chave, atualize sua aplicação com o novo valor. Confirme também se sua assinatura Pro ainda está ativa.
Comparação de Acesso à API: Perplexity Gratuito vs Pro
| Item | Plano Gratuito | Plano Pro |
|---|---|---|
| Geração de chave de API | Não disponível | Disponível em Configurações > API |
| Custo mensal | US$ 0 | US$ 20 |
| Limite de taxa | Nenhum | Nível superior, depende do uso |
| Acesso a modelos | Apenas modelo padrão do Perplexity | GPT-4, Claude, Llama e mais |
Agora você tem uma chave de API do Perplexity funcional e sabe como usá-la com segurança. Comece fazendo uma solicitação de teste com curl ou um script Python para verificar se a chave funciona. Para aplicações em produção, sempre rotacione as chaves periodicamente e monitore o uso pelo painel de API em Configurações.