Se você está criando um aplicativo que envia várias requisições para a API Perplexity ao mesmo tempo, precisa conhecer o limite de concorrência. Enviar requisições paralelas em excesso pode resultar em erros HTTP 429 Too Many Requests e interromper seu serviço. O limite de concorrência controla quantas chamadas de API sua conta pode fazer simultaneamente. Este artigo explica os limites exatos para os planos Free, Pro e Enterprise e como permanecer dentro deles.
Principais Conclusões: Limites de Concorrência da API Perplexity
- Plano Free: 1 requisição por vez. Qualquer requisição adicional retorna um erro 429.
- Plano Pro: 5 requisições simultâneas. Adequado para tarefas de automação de pequeno a médio porte.
- Plano Enterprise: Limites personalizados negociados com a Perplexity. Sem teto fixo.
Por que a Perplexity Impõe um Limite de Concorrência
O limite de concorrência protege a infraestrutura da API contra sobrecarga. Quando uma conta envia muitas requisições paralelas, pode degradar os tempos de resposta para todos os usuários. A Perplexity define limites por plano para garantir uma distribuição justa dos recursos.
O limite se aplica ao número de requisições ativas em um determinado momento. Uma requisição está ativa desde o momento em que o cliente envia o HTTP POST até que a API retorne uma resposta completa. Se você enviar 10 requisições de uma vez em um plano Pro, apenas 5 começarão a ser processadas. As outras 5 recebem um erro 429 imediato e não são enfileiradas.
Como o Limite Difere dos Limites de Taxa
Concorrência não é o mesmo que limite de taxa. Um limite de taxa restringe requisições por minuto ou por hora. A concorrência restringe requisições simultâneas em andamento. Por exemplo, o plano Pro pode permitir 100 requisições por minuto, mas apenas 5 ao mesmo tempo. Você pode enviar 5 requisições, aguardar a conclusão e depois enviar mais 5.
Como Verificar Seu Limite de Concorrência Atual
- Faça login no Painel da API Perplexity
Acesse perplexity.ai/settings/api. Faça login com suas credenciais. - Localize a Seção de Detalhes do Plano
Role até a seção chamada Detalhes do Plano ou Uso. O nome do seu plano e o limite de concorrência aparecem ao lado de Requisições Simultâneas. - Verifique os Cabeçalhos de Resposta HTTP
Após uma chamada de API bem-sucedida, inspecione os cabeçalhos de resposta. Procure porX-RateLimit-ConcurrenteX-RateLimit-Concurrent-Remaining. Esses cabeçalhos mostram seu limite e quantos slots simultâneos ainda estão livres.
O que Acontece Quando Você Excede o Limite de Concorrência
Quando sua conta envia mais requisições paralelas do que o permitido, a API retorna um código de status HTTP 429. O corpo da resposta contém um objeto JSON com uma mensagem de erro e um campo retry_after. O valor retry_after informa quantos segundos esperar antes de enviar uma nova requisição.
Exemplo de resposta:
{
"error": {
"message": "Muitas requisições simultâneas. Limite: 5.",
"type": "rate_limit_error",
"retry_after": 10
}
}
A API não enfileira requisições em excesso. Você deve implementar lógica de repetição em seu aplicativo para lidar com esses erros de forma adequada.
Se Você Precisar de Mais Concorrência
Usuários do Plano Free
O plano Free permite apenas 1 requisição simultânea. Para aumentar a concorrência, faça upgrade para o plano Pro. Vá em Configurações > Assinatura e selecione o nível Pro. Após o processamento do pagamento, seu limite de concorrência aumenta para 5.
Usuários do Plano Pro
Se 5 requisições simultâneas não forem suficientes, entre em contato com o suporte da Perplexity pelo painel. Explique seu caso de uso e volume esperado. A Perplexity pode oferecer um plano Enterprise personalizado com um limite de concorrência maior.
Usuários do Plano Enterprise
Os contratos Enterprise incluem limites de concorrência personalizados. Seu gerente de conta fornece o número exato no contrato. Você também pode solicitar um aumento temporário para testes ou eventos de lançamento.
Problemas Comuns com Limites de Concorrência
Erros 429 Mesmo Dentro do Limite
Se você receber erros 429, mas acreditar que está dentro do limite de concorrência, verifique outros limites de taxa. A API também impõe um limite de requisições por minuto. Você pode estar excedendo esse limite mesmo que a concorrência esteja ok. Verifique o cabeçalho X-RateLimit-Remaining para ver sua cota por minuto.
Várias Chaves de API da Mesma Conta
Usar várias chaves de API da mesma conta não aumenta a concorrência. O limite se aplica à conta, não à chave. Todas as chaves compartilham o mesmo pool de concorrência. Crie contas separadas para aplicativos distintos se precisar de mais concorrência.
O Limite de Concorrência é Reiniciado Após uma Requisição Longa
Uma única requisição de longa duração (por exemplo, uma pesquisa complexa que leva 30 segundos) ocupa um slot simultâneo durante toda a duração. Outras requisições precisam esperar. Para evitar bloqueios, defina um tempo limite no seu cliente HTTP. Se a requisição exceder um tempo razoável, cancele-a e tente novamente.
API Perplexity Free vs Pro: Concorrência e Outros Limites
| Item | Plano Free | Plano Pro |
|---|---|---|
| Requisições simultâneas | 1 | 5 |
| Requisições por minuto | 20 | 100 |
| Modelos disponíveis | Apenas Perplexity Online | Perplexity Online, GPT-4, Claude 3 |
| Custo mensal | Grátis | $20 por usuário por mês |
Os limites do plano Enterprise não estão listados porque são negociados por contrato. Entre em contato com o setor de vendas da Perplexity para obter detalhes.
Agora você conhece os limites de concorrência para cada plano da API Perplexity. Verifique seu plano no painel da API e monitore o cabeçalho X-RateLimit-Concurrent-Remaining em seu aplicativo. Se precisar de mais concorrência, faça upgrade para o Pro ou solicite um plano Enterprise. Use um sistema de fila em seu código para enviar requisições em lotes e evitar erros 429.