Cómo utilizar la API de Perplexity AI con o sin una cuenta Pro

Perplexity AI ha ganado una gran popularidad por sus capacidades de IA conversacional, particularmente su fortaleza en proporcionar respuestas actualizadas y citadas por fuentes al integrar la búsqueda web en tiempo real en sus respuestas. Para desarrolladores y empresas que buscan aprovechar estos potentes modelos dentro de sus propias aplicaciones, Perplexity ofrece una Interfaz de Programación de Aplicaciones (API).

La API de Perplexity AI permite el acceso programático a los grandes modelos de lenguaje (LLMs) de Perplexity, incluidos sus modelos en línea (como sonar-small-online y sonar-medium-online) que pueden navegar por la web para responder consultas, y sus modelos de chat fuera de línea (como sonar-small-chat y sonar-medium-chat).

Este tutorial explora dos caminos principales para interactuar con el ecosistema de la API de Perplexity AI:

Acceso Directo usando una Clave API Oficial de Perplexity: Este es el método estándar proporcionado por Perplexity. Aunque puede haber una prueba gratuita muy limitada o créditos introductorios, el uso sostenido o de alto volumen generalmente requiere una suscripción Pro de Perplexity o acuerdos empresariales específicos para obtener y utilizar una clave API con créditos suficientes.
Acceso Indirecto a través de Servicios de Terceros (OpenRouter): Plataformas como OpenRouter actúan como agregadores, proporcionando acceso a varios LLMs, incluidos los modelos de Perplexity, a través de su propia infraestructura API. Esta puede ser una forma alternativa de utilizar los modelos de Perplexity, potencialmente sin necesidad de una suscripción Pro directa de Perplexity, aunque aún incurrirás en costos a través del proveedor de terceros.

También aclararemos la situación respecto a Groq, otra popular plataforma de inferencia, y su relación (o falta de ella) con los modelos propietarios de Perplexity.

Accediendo a la API Oficial de Perplexity AI con una Cuenta Pro

Esta sección detalla cómo utilizar la API oficial proporcionada directamente por Perplexity. Este método generalmente ofrece el acceso más directo y potencialmente las características o modelos más recientes, pero generalmente requiere una suscripción paga a Perplexity (Pro) para un uso significativo más allá de la exploración inicial.

Requisitos Previos:

Una Cuenta de Perplexity.
Una suscripción Pro de Perplexity (generalmente requerida para un acceso sustancial a la API y generación de claves).
Comprensión básica de las APIs REST y cómo hacer solicitudes HTTP (usando herramientas como curl o lenguajes de programación como Python).

Paso 1: Obtener tu Clave API Oficial de Perplexity AI

Iniciar sesión en Perplexity: Ve al sitio web de Perplexity (perplexity.ai) e inicia sesión en tu cuenta. Asegúrate de que esté actualizada a Pro si es necesario para la generación/uso de la clave API.
Configura un Método de Pago: Busca la configuración de la cuenta, opciones de perfil, o una sección dedicada de 'API' en tu panel de Perplexity. La ubicación exacta puede cambiar, pero generalmente se encuentra en el área de gestión de tu cuenta.

3. Generar Clave API: Dentro de la configuración de la API, deberías encontrar una opción para generar una nueva clave API. Haz clic en este botón.

4. Copia y Asegura Tu Clave: Perplexity generará una cadena alfanumérica única. Esta es tu clave API. Trata esta clave como una contraseña. No la compartas públicamente ni la incluyas directamente en tus repositorios de código. Almacénala de forma segura, por ejemplo, usando variables de entorno o un sistema de gestión de secretos.

Paso 2: Comprender el Endpoint de la API de Perplexity AI

El endpoint principal para interactuar con los modelos de chat de Perplexity a través de la API es:

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

Este endpoint sigue una estructura similar a la API de OpenAI, lo que lo hace relativamente familiar para los desarrolladores que han trabajado con otras APIs de LLM.

Paso 3: Elegir un Modelo de API de Perplexity AI

Perplexity ofrece varios modelos a través de su API. Necesitas especificar qué modelo deseas usar en tu solicitud API. Los modelos comunes incluyen:

Modelos en Línea (con búsqueda web):

sonar-small-online
sonar-medium-online
(Anteriormente pplx-7b-online, pplx-70b-online - consulta la documentación actual para modelos disponibles)

Modelos de Chat (sin búsqueda web):

sonar-small-chat
sonar-medium-chat
(Anteriormente pplx-7b-chat, pplx-70b-chat - consulta la documentación actual)
Otros modelos especializados o más antiguos también pueden estar disponibles. Siempre consulta la documentación oficial de la API de Perplexity para la lista más actualizada de modelos y sus capacidades.

Paso 4: Hacer Tu Primera Solicitud a la API de Perplexity AI

Puedes interactuar con la API usando varias herramientas o lenguajes de programación. Aquí hay ejemplos usando curl (herramienta de línea de comandos) y Python (requests biblioteca).

Usando curl:

curl -X POST <https://api.perplexity.ai/chat/completions> \\\\
     -H "Authorization: Bearer YOUR_PERPLEXITY_API_KEY" \\\\
     -H "Content-Type: application/json" \\\\
     -d '{
       "model": "sonar-medium-online",
       "messages": [
         {
           "role": "system",
           "content": "Sé preciso y conciso."
         },
         {
           "role": "user",
           "content": "¿Cuáles son los principales beneficios de usar la API de Perplexity AI?"
         }
       ],
       "max_tokens": 500,
       "temperature": 0.7
     }'

Explicación:

curl -X POST ...: Realiza una solicitud HTTP POST al endpoint especificado.
H "Authorization: Bearer YOUR_PERPLEXITY_API_KEY": Este encabezado proporciona tus credenciales de autenticación. Reemplaza YOUR_PERPLEXITY_API_KEY con la clave que generaste.
H "Content-Type: application/json": Informa al servidor que el cuerpo de la solicitud está en formato JSON.
d '{...}': Especifica la carga útil JSON (datos) que se envía.
"model": El modelo específico de Perplexity que se utilizará (por ejemplo, sonar-medium-online).
"messages": Una lista de objetos de mensaje que definen el historial de la conversación.
"role": Puede ser "system" (establece el comportamiento de la IA), "user" (tu entrada), o "assistant" (respuestas anteriores de la IA).
"content": El texto del mensaje.
"max_tokens" (opcional): Número máximo de tokens a generar en la respuesta.
"temperature" (opcional): Controla la aleatoriedad (0 = determinista, más alto = más creativo/aleatorio).

Usando Python (requests biblioteca):

Primero, asegúrate de tener la biblioteca requests instalada: pip install requests

import requests
import json
import os

# Carga segura tu clave API (por ejemplo, desde una variable de entorno)
api_key = os.environ.get("PERPLEXITY_API_KEY")
# O descomenta y reemplaza directamente (menos seguro para producción):
# api_key = "YOUR_PERPLEXITY_API_KEY"

if not api_key:
    print("Error: variable de entorno PERPLEXITY_API_KEY no configurada.")
else:
    url = "<https://api.perplexity.ai/chat/completions>"

    payload = {
        "model": "sonar-medium-online",
        "messages": [
            {
                "role": "system",
                "content": "Proporciona explicaciones detalladas y cita fuentes."
            },
            {
                "role": "user",
                "content": "Explica el concepto de Generación Aumentada por Recuperación (RAG)."
            }
        ],
        "max_tokens": 800,
        "temperature": 0.5,
        # Agrega otros parámetros como 'frequency_penalty', 'presence_penalty' si es necesario
    }

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

    try:
        response = requests.post(url, headers=headers, json=payload)
        response.raise_for_status() # Lanza una excepción por códigos de estado erróneos (4xx o 5xx)

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

        # Extraer la respuesta del asistente
        if response_data.get("choices"):
             assistant_message = response_data["choices"][0]["message"]["content"]
             print("\\\\nRespuesta del Asistente:\\\\n", assistant_message)

    except requests.exceptions.RequestException as e:
        print(f"Ocurrió un error: {e}")
        if e.response is not None:
            print("Detalles del error:", e.response.text)

Paso 5: Probar tu Clave API de Perplexity AI con APIdog

Antes de integrar la clave API en tu aplicación, es prudente probarla para asegurarte de que funcione correctamente. APIdog es una herramienta fácil de usar para probar APIs. Así es como puedes usarla para probar tu clave de Perplexity:

Descargar y Abrir APIdog: Inicia la aplicación APIdog o usa la versión web.

button

Crear una Nueva Solicitud: Haz clic en el botón "+" o en una opción similar para crear una nueva solicitud API.

Establecer Método en POST: Cambia el menú desplegable del método HTTP a POST.

Ingresar URL del Endpoint: En el campo de entrada de URL, pega el endpoint de completions de chat de Perplexity: https://api.perplexity.ai/chat/completions

Configurar Autorización:

Ve a la pestaña 'Authorization' debajo de la barra de URL.
Selecciona 'Bearer Token' en el menú desplegable de tipo.
En el campo 'Token', pega tu clave API de Perplexity AI obtenida en el Paso 1.

Establecer Encabezado Content-Type:

Ve a la pestaña 'Headers'.
Agrega un nuevo encabezado. Establece la clave en Content-Type y el valor en application/json.

Construir el Cuerpo de la Solicitud:

Ve a la pestaña 'Body'.
Selecciona la opción 'raw' y elige 'JSON' en el menú desplegable junto a ella.
Pega la siguiente estructura JSON en el área de texto, reemplazando "sonar-medium-online" con el modelo que deseas probar y ajustando el "content" si lo deseas:

{
  "model": "sonar-medium-online",
  "messages": [
    {
      "role": "system",
      "content": "Sé preciso y fáctico."
    },
    {
      "role": "user",
      "content": "¿Cuántas lunas tiene Marte?"
    }
  ]
}

Enviar la Solicitud: Haz clic en el botón 'Send'.

Verificar la Respuesta: APIdog mostrará la respuesta de la API de Perplexity. Busca un código de estado 200 OK y una respuesta JSON que contenga la respuesta de la IA en el campo choices[0].message.content. Si obtienes un error (como un 401 Unauthorized o 403 Forbidden), verifica que tu clave API se haya pegado correctamente en la pestaña de Autorización y que tu cuenta/clave de Perplexity tenga los permisos y créditos necesarios.

💡

¿Quieres una gran herramienta de Pruebas de API que genere hermosa Documentación de API?

¿Quieres una plataforma integrada, Todo-en-Uno para que tu equipo de desarrolladores trabaje junto con máxima productividad?

APIdog satisface todas tus demandas, y reemplaza a Postman a un precio mucho más asequible!

button

Usando Modelos de la API de Perplexity AI Sin una Cuenta Pro Directa (con Openrouter)

Si no tienes una suscripción Pro de Perplexity o prefieres un modelo de facturación/acceso diferente, a menudo puedes usar los modelos de Perplexity a través de proveedores de API de terceros. OpenRouter es un ejemplo popular.

OpenRouter proporciona un endpoint API unificado para acceder a una amplia variedad de LLMs de diferentes proveedores, incluidos Perplexity. Pagas a OpenRouter según tu uso, y ellos manejan las llamadas de backend a los respectivos proveedores de modelos.

Puedes consultar la API de Perplexity AI disponible aquí:

Requisitos Previos:

Una Cuenta de OpenRouter (openrouter.ai).
Fondos añadidos a tu cuenta de OpenRouter o configuración de facturación.
Comprensión básica de las APIs REST.

Paso 1: Obtener tu Clave API de OpenRouter

Registrarse/Iniciar sesión: Ve a openrouter.ai y crea una cuenta o inicia sesión.
Navegar a Claves: Encuentra la sección 'Keys' o 'API Keys' en la configuración de tu cuenta.
Crear Clave: Genera una nueva clave API.
Copia y Asegura: Copia la clave generada y guárdala de forma segura, al igual que la clave oficial de Perplexity.

Paso 2: Identificar Modelos de API de Perplexity AI en OpenRouter

OpenRouter utiliza su propia convención de nomenclatura, a menudo prefijando el nombre del proveedor. Los modelos de Perplexity en OpenRouter pueden verse como:

perplexity/sonar-small-chat
perplexity/sonar-small-online
perplexity/sonar-medium-chat
perplexity/sonar-medium-online
(Consulta la página /models de OpenRouter para la lista actual y los nombres exactos)

Paso 3: Hacer Solicitud API a través del Endpoint de OpenRouter para Modelos de API de Perplexity AI

OpenRouter utiliza un endpoint API compatible con OpenAI:

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

Estructuras tu solicitud de manera similar a la API oficial de Perplexity o a la API de OpenAI, pero usa tu clave de OpenRouter y el nombre del modelo de OpenRouter.

Usando curl:

curl -X POST <https://openrouter.ai/api/v1/chat/completions> \\\\
  -H "Authorization: Bearer YOUR_OPENROUTER_API_KEY" \\\\
  -H "Content-Type: application/json" \\\\
  -H "HTTP-Referer: YOUR_SITE_URL" \\\\ # Opcional, pero recomendado por OpenRouter
  -H "X-Title: YOUR_APP_NAME" \\\\      # Opcional, pero recomendado por OpenRouter
  -d '{
    "model": "perplexity/sonar-medium-online",
    "messages": [
      {"role": "user", "content": "¿Cómo proporciona OpenRouter acceso a los modelos de API de Perplexity AI?"}
    ]
  }'

Nota: OpenRouter recomienda agregar encabezados HTTP-Referer y X-Title para identificar tu aplicación. Reemplaza YOUR_OPENROUTER_API_KEY, YOUR_SITE_URL, y YOUR_APP_NAME según corresponda.

Paso 4: Manejar la Respuesta de OpenRouter para Modelos de API de Perplexity AI

La estructura de respuesta de OpenRouter es generalmente idéntica al estándar de OpenAI/Perplexity, incluyendo campos choices, message, content, y usage. La principal diferencia es que los costos se calculan según la tarifa de OpenRouter para el modelo específico de Perplexity que utilizaste.

Beneficios de usar OpenRouter:

Acceso a los modelos de Perplexity sin necesidad de una suscripción Pro directa de Perplexity.
Facturación consolidada para múltiples LLMs de diferentes proveedores.
Una sola clave API y endpoint para varios modelos.

Consideraciones:

Los precios pueden diferir de los costos de la API directa de Perplexity.
Posibilidad de una latencia ligeramente mayor debido al salto adicional.
Dependencia de la disponibilidad de la plataforma de OpenRouter y su integración con Perplexity.

Conclusión

Este tutorial proporciona una guía detallada para acceder a los potentes modelos detrás de Perplexity AI a través de varios métodos de API. Recuerda siempre consultar la documentación oficial de Perplexity y OpenRouter para los nombres de modelos, endpoints, precios y características más actuales. Asegura tus claves API y elige el método de acceso que mejor se adapte a los requisitos y presupuesto de tu proyecto.