A API Perplexity Sonar permite integrar recursos de busca em tempo real em seus próprios aplicativos, bots ou fluxos de trabalho. Em vez de visitar o site do Perplexity, você pode enviar uma pergunta e receber uma resposta com citações de forma programática. Este artigo explica o que é a API Sonar, o que você precisa para configurá-la e como fazer sua primeira chamada de API.
Escolher o modelo certo da API Perplexity para sua aplicação pode ser confuso. A família Sonar inclui três níveis: Sonar, Sonar Pro e Sonar Reasoning. Cada modelo oferece profundidade de busca, capacidade de raciocínio e custo diferentes. Este artigo explica as diferenças entre esses três modelos, seus casos de uso ideais e como configurá-los em suas chamadas de API. Leia mais
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 … Leia mais
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