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
Ao usar a API Perplexity, você pode perceber que não há um parâmetro direto para definir o Modo de Foco. A API não expõe um campo focus_mode, então não é possível alternar programaticamente entre os domínios de busca Web, Acadêmico, Escrita, Matemática, Vídeo ou Social. Essa limitação significa que suas chamadas de API sempre usarão o domínio de busca padrão, que é o Web. Este artigo explica por que o Modo de Foco está ausente na API e fornece uma solução prática para simular pesquisas específicas de domínio usando engenharia de prompt e formatação de consulta.
Ao fazer chamadas de API para o Perplexity, você pode precisar definir o comportamento do modelo de IA antes de processar as mensagens do usuário. Um system prompt define o papel, o tom e as restrições para o assistente. Sem um system prompt colocado corretamente, o modelo pode responder de forma padrão que não atende às necessidades da sua aplicação. … Leia mais