Construye tu propia app con la Sonar API de Perplexity

⏱ Tiempo estimado: 20 minutos 🎯 Rama / Perfil: Desarrolladores y makers técnicos 🧠 Conocimiento previo necesario: Nociones básicas de Python (variables, funciones) y haber usado la interfaz web de Perplexity (visto en el curso de Platzi). 💡 ¿Qué vas a lograr? Un script en Python que envía una pregunta a Perplexity por código y recibe una respuesta con fuentes citadas, sin pasar por la interfaz web.

🛠 Lo que necesitas antes de empezar

• Cuenta de Perplexity con acceso a la API (requiere método de pago para activar la API Console) → 🔗 API Console de Perplexity
• Python 3.8 o superior instalado → 🔗 Descarga oficial de Python
• Un editor de código (VS Code, por ejemplo)

📋 Pasos

Paso 1 — Genera tu API key

Entra a la API Console de Perplexity y crea una nueva clave desde la sección de API Keys. 🔗 Perplexity API Console — API Keys

Guarda esa clave en un lugar seguro; la vas a necesitar en el paso 3. La API funciona con pago por uso (no requiere suscripción fija) y las tarifas se calculan según el consumo de cada llamada. AI Pricing Guru

Paso 2 — Instala el SDK oficial

Abre una terminal y corre:

bash

pip install perplexityai

Este paquete te da acceso directo a los modelos Sonar de Perplexity desde Python, sin tener que armar las peticiones HTTP a mano.

Paso 3 — Configura tu API key como variable de entorno

En macOS/Linux:

bash

export PERPLEXITY_API_KEY="tu_api_key_aqui"

En Windows:

powershell

setx PERPLEXITY_API_KEY "tu_api_key_aqui"

El SDK lee esta variable automáticamente, así que no necesitas escribir la clave dentro de tu código.

Paso 4 — Escribe tu primer script

Crea un archivo consulta.py con este contenido:

python

from perplexity import Perplexity

client = Perplexity()  # lee PERPLEXITY_API_KEY automáticamente

completion = client.chat.completions.create(
    model="sonar-pro",
    messages=[
        {"role": "user", "content": "¿Cuáles son las tendencias más recientes en adopción de IA en pymes de Latinoamérica?"}
    ]
)

print(completion.choices[0].message.content)
print("\nFuentes:")
for cita in completion.citations:
    print("-", cita)

Cambia la pregunta por un tema que te interese: eso es lo que diferencia esto de usar la web de Perplexity — ahora puedes automatizar cualquier pregunta que quieras.

Paso 5 — Ejecuta y revisa el resultado

bash

python consulta.py

Vas a ver la respuesta generada por el modelo sonar-pro, seguida de la lista de URLs que respaldan cada afirmación — el mismo principio de "fuentes verificables" del curso, pero ahora disponible para integrarlo en cualquier app, bot o automatización tuya.

✅ Resultado esperado

Un script consulta.py funcional que, al ejecutarse, imprime una respuesta generada con búsqueda web en tiempo real junto con sus fuentes citadas. Esta es la base para cualquier integración futura: un bot de Slack, un endpoint en tu backend, o una automatización de research.

🔥 Tu reto (siguiente acción)

Modifica el script para que reciba la pregunta como argumento desde la terminal (sys.argv) en lugar de tenerla escrita fija en el código, y guarda cada respuesta con sus fuentes en un archivo .md distinto por consulta. Así tienes tu primer mini historial de investigación generado por API.

📚 Recursos para ir más lejos

• Guía de inicio rápido — Sonar API — documentación oficial con ejemplos en Python, TypeScript y cURL
• Precios de la API — para entender cuánto cuesta cada llamada antes de escalar