Perplexity

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.

Gerenciar o volume de requisições de API é essencial ao integrar o Perplexity em seus aplicativos. Sem limites de taxa, seu código pode sobrecarregar o servidor da API, gerar erros HTTP 429 Too Many Requests ou exceder sua cota de assinatura inesperadamente. Este artigo explica como configurar limites de taxa em requisições da API Perplexity usando as melhores práticas para Python, JavaScript e cabeçalhos HTTP. Você aprenderá a implementar throttling no lado do cliente, ler limites do servidor a partir dos cabeçalhos de resposta e lidar com backoff de forma adequada.

Você chama a API do Perplexity e recebe o código HTTP 429 com a mensagem “Rate Limit Exceeded.” Esse erro interrompe sua aplicação ou script. A causa é simples: você enviou mais requisições do que seu plano ou chave permite em um intervalo de tempo. Este artigo explica por que o erro 429 ocorre e oferece três soluções concretas que você pode aplicar agora.

Quando você usa a API do Perplexity para gerar respostas com busca na web, a resposta inclui um campo citations que lista as URLs das fontes utilizadas. No entanto, muitos desenvolvedores encontram esse campo ausente ou vazio na saída da API. Isso geralmente acontece porque a requisição foi enviada sem o parâmetro necessário que ativa a coleta de citações. Este artigo explica como … Leia mais

Ao chamar a API do Perplexity e o array de citações retornar vazio, seu aplicativo não consegue exibir as fontes da resposta. Isso quebra o valor central das respostas baseadas em pesquisa do Perplexity. O problema geralmente ocorre porque o parâmetro return_citations não está definido como true na sua requisição. Este artigo explica a causa exata e mostra como corrigir o array de citações vazio na sua integração com a API.

Transmitir respostas da API Perplexity usando Server-Sent Events permite que seu aplicativo exiba respostas em tempo real conforme são geradas, em vez de esperar pela resposta completa. SSE é um protocolo padrão que envia dados do servidor para o cliente em uma única conexão HTTP. Este artigo explica como configurar sua requisição para ativar a transmissão e como lidar com o fluxo de eventos recebidos em JavaScript e Python. Você aprenderá os parâmetros exatos, tipos de evento e padrões de código necessários para uma implementação funcional.

Quando você usa a API Perplexity para respostas em streaming, a saída pode parar antes do modelo terminar de gerar uma resposta. Esse corte precoce interrompe fluxos de trabalho que dependem de respostas completas, como resumos automatizados de pesquisa ou chatbots voltados para o cliente. O problema geralmente decorre de configurações de timeout no lado do cliente, interrupções de rede ou parâmetros da API mal configurados. Este artigo explica … Leia mais

Você quer chamar a API do Perplexity a partir do código Python, mas prefere usar o familiar SDK da OpenAI em vez de uma biblioteca separada. A API do Perplexity é totalmente compatível com o cliente OpenAI porque usa o mesmo formato de endpoint de chat completions. Este artigo explica como configurar o SDK Python da OpenAI para conectar-se ao Perplexity, … Leia mais

Desenvolvedores que criam aplicativos com IA frequentemente perguntam se a API Perplexity funciona com ferramentas e bibliotecas feitas para OpenAI. A API Perplexity foi projetada para ser compatível com as bibliotecas de cliente e o formato da API OpenAI, facilitando a migração ou integração. Este artigo explica exatamente quais recursos da OpenAI são suportados pela API Perplexity e quais não são. Você aprenderá as principais diferenças em endpoints, parâmetros, autenticação e comportamento de streaming.

A Perplexity oferece vários modelos de IA através de sua API, incluindo llama-3.1-sonar-small-128k-online, llama-3.1-sonar-large-128k-online e llama-3.1-sonar-huge-128k-online. Cada modelo tem capacidades diferentes em termos de velocidade, custo e qualidade das respostas. Você pode precisar alternar entre esses modelos para tarefas diferentes, como consultas rápidas versus pesquisas aprofundadas. Este artigo explica como especificar o parâmetro do modelo em uma … Leia mais