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:

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.
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:

Uma Conta na Perplexity.
Uma assinatura Pro da Perplexity (geralmente necessária para acesso substancial à API e geração de chaves).
Conhecimento básico sobre APIs REST e como fazer solicitações HTTP (usando ferramentas como curl ou linguagens de programação como Python).

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

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.
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):

sonar-small-online
sonar-medium-online
(Anteriormente pplx-7b-online, pplx-70b-online - consulte a documentação atual para modelos disponíveis)

Modelos de Chat (sem pesquisa na web):

sonar-small-chat
sonar-medium-chat
(Anteriormente pplx-7b-chat, pplx-70b-chat - consulte a documentação atual)
Outros modelos especializados ou mais antigos também podem estar disponíveis. Sempre consulte a documentação oficial da API da Perplexity para a lista mais atualizada de modelos e suas capacidades.

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:

curl -X POST ...: Faz uma solicitação HTTP POST para o endpoint especificado.
H "Authorization: Bearer SUA_CHAVE_DA_API_PERPLEXITY": Este cabeçalho fornece suas credenciais de autenticação. Substitua SUA_CHAVE_DA_API_PERPLEXITY pela chave que você gerou.
H "Content-Type: application/json": Informa ao servidor que o corpo da solicitação está no formato JSON.
d '{...}': Especifica a carga útil JSON (dados) a serem enviados.
"model": O modelo específico da Perplexity a ser utilizado (por exemplo, sonar-medium-online).
"messages": Uma lista de objetos de mensagem definindo o histórico da conversa.
"role": Pode ser "system" (define o comportamento da IA), "user" (seu input) ou "assistant" (respostas anteriores da IA).
"content": O texto da mensagem.
"max_tokens" (opcional): Número máximo de tokens a serem gerados na resposta.
"temperature" (opcional): Controla a aleatoriedade (0 = determinístico, maior = mais criativo/aleatório).

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:

Vá para a aba 'Autorização' abaixo da barra de URL.
Selecione 'Bearer Token' no menu do tipo.
No campo 'Token', cole sua chave da API da Perplexity AI obtida no Passo 1.

Defina o Cabeçalho Content-Type:

Vá para a aba 'Headers'.
Adicione um novo cabeçalho. Defina a chave como Content-Type e o valor como application/json.

Construa o Corpo da Solicitação:

Vá para a aba 'Body'.
Selecione a opção 'raw' e escolha 'JSON' no menu suspenso ao lado.
Cole a seguinte estrutura JSON na área de texto, substituindo "sonar-medium-online" pelo modelo que deseja testar e ajustando o "content", se desejado:

{
  "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:

Uma Conta no OpenRouter (openrouter.ai).
Crédito adicionado à sua conta do OpenRouter ou configuração de faturamento.
Conhecimento básico sobre APIs REST.

Passo 1: Obtenha Sua Chave de API do OpenRouter

Inscreva-se/Entre: Vá para openrouter.ai e crie uma conta ou faça login.
Navegue até Chaves: Encontre a seção 'Chaves' ou 'Chaves de API' nas configurações da sua conta.
Criar Chave: Gere uma nova chave de API.
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:

perplexity/sonar-small-chat
perplexity/sonar-small-online
perplexity/sonar-medium-chat
perplexity/sonar-medium-online
(Verifique a página /models do OpenRouter para a lista atual e os nomes exatos)

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:

Acesse modelos da Perplexity sem precisar de uma assinatura Pro direta da Perplexity.
Faturamento consolidado para múltiplos LLMs de diferentes provedores.
Uma única chave de API e endpoint para vários modelos.

Considerações:

A precificação pode diferir dos custos diretos da API da Perplexity.
Potencial para latência um pouco maior devido ao salto extra.
Dependente da disponibilidade da plataforma OpenRouter e de sua integração com a Perplexity.

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.