Blog

Como usar a API do Perplexity AI com ou sem uma conta Pro

@apidog

@apidog

17 abril 2025

Como usar a API do Perplexity AI com ou sem uma conta Pro

A Perplexity AI ganhou popularidade significativa por suas capacidades de IA conversacional, especialmente sua força em fornecer respostas atualizadas e citadas por fontes, integrando a busca na web em tempo real em suas respostas. Para desenvolvedores e empresas que desejam aproveitar esses poderosos modelos em suas próprias aplicações, a Perplexity oferece uma Interface de Programação de Aplicativos (API).

A API da Perplexity AI permite acesso programático aos grandes modelos de linguagem (LLMs) da Perplexity, incluindo seus modelos online (como sonar-small-online e sonar-medium-online), que podem navegar na web para responder a consultas, e seus modelos de chat offline (como sonar-small-chat e sonar-medium-chat).

Este tutorial explora duas principais maneiras de interagir com o ecossistema da API da Perplexity AI:

  1. Acesso Direto usando uma Chave de API Oficial da Perplexity: Este é o método padrão fornecido pela Perplexity. Embora possa haver uma versão de teste gratuita ou créditos introdutórios muito limitados, o uso contínuo ou de alto volume geralmente requer uma assinatura Pro da Perplexity ou acordos empresariais específicos para obter e utilizar uma chave de API com créditos suficientes.
  2. Acesso Indireto via Serviços de Terceiros (OpenRouter): Plataformas como o OpenRouter atuam como agregadores, fornecendo acesso a vários LLMs, incluindo os modelos da Perplexity, através de sua própria infraestrutura de API. Esta pode ser uma maneira alternativa de usar os modelos da Perplexity, potencialmente sem precisar de uma assinatura Pro direta da Perplexity, embora você ainda incorra em custos através do provedor de terceiros.

Também esclareceremos a situação em relação à Groq, outra plataforma popular de inferência, e sua relação (ou falta dela) com os modelos proprietários da Perplexity.

Acessando a API Oficial da Perplexity AI com uma Conta Pro

Esta seção detalha como usar a API oficial fornecida diretamente pela Perplexity. Este método normalmente oferece o acesso mais direto e, potencialmente, os recursos ou modelos mais recentes, mas geralmente requer uma assinatura paga da Perplexity (Pro) para um uso significativo além da exploração inicial.

Requisitos:

Passo 1: Obtendo Sua Chave de API Oficial da Perplexity AI

  1. Faça login na Perplexity: Vá para o site da Perplexity (perplexity.ai) e faça login na sua conta. Certifique-se de que está atualizada para Pro, se necessário, para a geração/uso da chave da API.
  2. Configure um Método de Pagamento: Procure nas configurações da conta, opções de perfil ou uma seção dedicada 'API' no seu painel da Perplexity. O local exato pode mudar, mas normalmente está sob a área de gerenciamento da sua conta.

3. Gerar Chave da API: Dentro das configurações da API, você deve encontrar uma opção para gerar uma nova chave da API. Clique neste botão.

4. Copie e Proteja sua Chave: A Perplexity gerará uma string alfanumérica única. Esta é sua chave da API. Trate esta chave como uma senha. Não a compartilhe publicamente ou a comprometa diretamente em seus repositórios de código. Armazene-a de forma segura, por exemplo, usando variáveis de ambiente ou um sistema de gerenciamento de segredos.

Passo 2: Entendendo o Endpoint da API da Perplexity AI

O endpoint principal para interagir com os modelos de chat da Perplexity através da API é:

https://api.perplexity.ai/chat/completions

Este endpoint segue uma estrutura semelhante à API da OpenAI, tornando-o relativamente familiar para desenvolvedores que já trabalharam com outras APIs de LLM.

Passo 3: Escolhendo um Modelo da API da Perplexity AI

A Perplexity oferece vários modelos através de sua API. Você precisa especificar qual modelo deseja usar em sua solicitação de API. Os modelos comuns incluem:

Modelos Online (com pesquisa na web):

Modelos de Chat (sem pesquisa na web):

Passo 4: Fazendo Sua Primeira Solicitação à API da Perplexity AI

Você pode interagir com a API usando várias ferramentas ou linguagens de programação. Aqui estão exemplos usando curl (ferramenta de linha de comando) e Python (requests biblioteca).

Usando curl:

curl -X POST <https://api.perplexity.ai/chat/completions> \\\\
     -H "Authorization: Bearer SUA_CHAVE_DA_API_PERPLEXITY" \\\\
     -H "Content-Type: application/json" \\\\
     -d '{
       "model": "sonar-medium-online",
       "messages": [
         {
           "role": "system",
           "content": "Seja preciso e conciso."
         },
         {
           "role": "user",
           "content": "Quais são os principais benefícios de usar a API da Perplexity AI?"
         }
       ],
       "max_tokens": 500,
       "temperature": 0.7
     }'

Explicação:

Usando Python (requests biblioteca):

Primeiro, certifique-se de que a biblioteca requests está instalada: pip install requests

import requests
import json
import os

# Carregue sua chave da API de forma segura (por exemplo, de uma variável de ambiente)
api_key = os.environ.get("PERPLEXITY_API_KEY")
# Ou descomente e substitua diretamente (menos seguro para produção):
# api_key = "SUA_CHAVE_DA_API_PERPLEXITY"

if not api_key:
    print("Erro: variável de ambiente PERPLEXITY_API_KEY não definida.")
else:
    url = "<https://api.perplexity.ai/chat/completions>"

    payload = {
        "model": "sonar-medium-online",
        "messages": [
            {
                "role": "system",
                "content": "Forneça explicações detalhadas e cite fontes."
            },
            {
                "role": "user",
                "content": "Explique o conceito de Geração Aumentada por Recuperação (RAG)."
            }
        ],
        "max_tokens": 800,
        "temperature": 0.5,
        # Adicione outros parâmetros como 'frequency_penalty', 'presence_penalty' se necessário
    }

    headers = {
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json"
    }

    try:
        response = requests.post(url, headers=headers, json=payload)
        response.raise_for_status() # Levanta uma exceção para códigos de status ruins (4xx ou 5xx)

        response_data = response.json()
        print(json.dumps(response_data, indent=2))

        # Extrai a resposta do assistente
        if response_data.get("choices"):
             assistant_message = response_data["choices"][0]["message"]["content"]
             print("\\\\nResposta do Assistente:\\\\n", assistant_message)

    except requests.exceptions.RequestException as e:
        print(f"Ocorreu um erro: {e}")
        if e.response is not None:
            print("Detalhes do erro:", e.response.text)

Passo 5: Testando Sua Chave da API Perplexity AI com APIdog

Antes de integrar a chave da API em sua aplicação, é prudente testá-la para garantir que está funcionando corretamente. O APIdog é uma ferramenta fácil de usar para testar APIs. Veja como usá-lo para testar sua chave da Perplexity:

Baixe e Abra o APIdog: Inicie o aplicativo APIdog ou use a versão web.

botão

Crie uma Nova Solicitação: Clique no botão "+" ou em uma opção semelhante para criar uma nova solicitação de API.

Defina o Método como POST: Altere o menu suspenso do método HTTP para POST.

Insira a URL do Endpoint: No campo de entrada da URL, cole o endpoint de completas de chat da Perplexity: https://api.perplexity.ai/chat/completions

Configure a Autorização:

Defina o Cabeçalho Content-Type:

Construa o Corpo da Solicitação:

{
  "model": "sonar-medium-online",
  "messages": [
    {
      "role": "system",
      "content": "Seja preciso e factual."
    },
    {
      "role": "user",
      "content": "Quantas luas Marte tem?"
    }
  ]
}

Envie a Solicitação: Clique no botão 'Enviar'.

Verifique a Resposta: O APIdog exibirá a resposta da API Perplexity. Procure por um código de status 200 OK e uma resposta JSON contendo a resposta da IA no campo choices[0].message.content. Se você receber um erro (como 401 Unauthorized ou 403 Forbidden), verifique se sua chave da API foi colada corretamente na aba de Autorização e se sua conta/chave da Perplexity possui as permissões e créditos necessários.

💡
Quer uma ótima ferramenta de Teste de API que gera documentação de API bonita?

Quer uma plataforma integrada, All-in-One para sua equipe de desenvolvedores trabalhar junta com máxima produtividade?

APIdog atende a todas as suas demandas e substitui o Postman a um preço muito mais acessível!
botão

Usando Modelos da API da Perplexity AI Sem uma Conta Pro Direta (com OpenRouter)

Se você não tem uma assinatura Pro da Perplexity ou prefere um modelo de cobrança/acesso diferente, muitas vezes pode usar os modelos da Perplexity através de provedores de API de terceiros. O OpenRouter é um exemplo popular.

O OpenRouter fornece um endpoint de API unificado para acessar uma ampla variedade de LLMs de diferentes provedores, incluindo a Perplexity. Você paga ao OpenRouter com base no seu uso, e eles gerenciam as chamadas de backend para os respectivos provedores de modelo.

Você pode conferir a API da Perplexity AI disponível aqui:

Requisitos:

Passo 1: Obtenha Sua Chave de API do OpenRouter

  1. Inscreva-se/Entre: Vá para openrouter.ai e crie uma conta ou faça login.
  2. Navegue até Chaves: Encontre a seção 'Chaves' ou 'Chaves de API' nas configurações da sua conta.
  3. Criar Chave: Gere uma nova chave de API.
  4. Copie e Proteja: Copie a chave gerada e armazene-a de forma segura, assim como a chave oficial da Perplexity.

Passo 2: Identificando Modelos da API da Perplexity AI no OpenRouter

O OpenRouter usa sua própria convenção de nomenclatura, frequentemente prefixando o nome do provedor. Os modelos da Perplexity no OpenRouter podem parecer:

Passo 3: Faça a Solicitação de API via Endpoint do OpenRouter para Modelos da API da Perplexity AI

O OpenRouter utiliza um endpoint de API compatível com a OpenAI:

https://openrouter.ai/api/v1/chat/completions

Você estrutura sua solicitação de maneira semelhante à API oficial da Perplexity ou à API da OpenAI, mas usa sua chave do OpenRouter e o nome do modelo do OpenRouter.

Usando curl:

curl -X POST <https://openrouter.ai/api/v1/chat/completions> \\\\
  -H "Authorization: Bearer SUA_CHAVE_API_OPENROUTER" \\\\
  -H "Content-Type: application/json" \\\\
  -H "HTTP-Referer: SUA_URL_SITE" \\\\ # Opcional, mas recomendado pelo OpenRouter
  -H "X-Title: NOME_DO_SEU_APP" \\\\      # Opcional, mas recomendado pelo OpenRouter
  -d '{
    "model": "perplexity/sonar-medium-online",
    "messages": [
      {"role": "user", "content": "Como o OpenRouter fornece acesso aos modelos da API da Perplexity AI?"}
    ]
  }'

Nota: O OpenRouter recomenda adicionar os cabeçalhos HTTP-Referer e X-Title para identificar sua aplicação. Substitua SUA_CHAVE_API_OPENROUTER, SUA_URL_SITE e NOME_DO_SEU_APP de acordo.

Passo 4: Manipulando a Resposta do OpenRouter para Modelos da API da Perplexity AI

A estrutura da resposta do OpenRouter é geralmente idêntica ao padrão OpenAI/Perplexity, incluindo os campos choices, message, content e usage. A principal diferença é que os custos são calculados com base na precificação do OpenRouter para o modelo específico da Perplexity que você usou.

Benefícios de usar o OpenRouter:

Considerações:

Conclusão

Este tutorial fornece um guia detalhado para acessar os poderosos modelos por trás da Perplexity AI através de vários métodos de API. Lembre-se de sempre consultar a documentação oficial da Perplexity, OpenRouter para os nomes de modelos, endpoints, preços e recursos mais atuais. Proteja suas chaves da API e escolha o método de acesso que melhor atenda às necessidades do seu projeto e orçamento.

Pratique o design de API no Apidog

Descubra uma forma mais fácil de construir e usar APIs

Cadastre-se gratuitamenteBaixar