Para usar la Perplexity API, entra a console.perplexity.ai, agrega un método de pago, compra créditos y genera tu llave en API keys → + Generate API Key. Se paga por uso, aparte de cualquier suscripción, y para un proyecto nuevo la API recomendada hoy es el Agent API, no Sonar.
Muchas guías en español siguen explicando la versión de 2025. Esta está verificada en la documentación oficial de Perplexity a octubre de 2026.
Qué es la API de Perplexity y cuál usar hoy
La API de Perplexity te deja llevar a tus propios sistemas las respuestas apoyadas en búsqueda web que Perplexity da en su app. En 2026 dejó de ser un solo producto: la documentación actual tiene varias API.
- Agent API (
POST https://api.perplexity.ai/v1/agent, con alias/v1/responses): la recomendada para proyectos nuevos. Eliges un preset (fast,low,medium,highoxhigh) o un modelo de terceros (Anthropic, OpenAI, Google o xAI) que usa la búsqueda web como herramienta. - Orchestrator API (
https://api.perplexity.ai/router/v1), lanzada en julio de 2026: modelos de pesos abiertos (los que su creador publica para que otros los puedan alojar) alojados por Perplexity, en el formato Chat Completions de OpenAI. - Sonar API (
https://api.perplexity.ai/v1/sonar): sigue documentada, pero ya no es la puerta principal. - Otras: Search API, Embeddings y Decisions API.
Qué pasó con Sonar y por qué una integración vieja puede fallar
La documentación lo dice textual: «Sonar Chat Completions support ended on September 27, 2026». Las peticiones síncronas y en streaming se están reformulando como peticiones del Agent API, y las asíncronas ya no se admiten.
Si tienes un flujo armado hace meses con el modelo sonar y el formato de OpenAI, revísalo contra la documentación actual antes de asumir que sigue igual. Y si una guía presenta Sonar como «la API de Perplexity», está desactualizada.
¿La suscripción Pro de Perplexity incluye la API?
Hoy no se puede afirmar. La ayuda oficial de facturación dice que la API es un servicio aparte que no requiere suscripción: «API access is available to all users as a separate service». Y la página de créditos dice que el plan Pro no tiene asignación mensual de esos créditos, que además son de otra función (Computer), no de la API.
Muchas guías repiten que Pro trae un crédito mensual de API. Ese dato no aparece hoy ni en la documentación ni en la ayuda de Perplexity. Si tu presupuesto depende de él, no cuentes con él hasta verlo en tu propia consola.
Cómo obtener la API key de Perplexity paso a paso
Entra a la consola de la API
La API se gestiona en console.perplexity.ai. La ruta vieja, perplexity.ai/settings/api, ahora redirige ahí.
Agrega un método de pago
En Billing → Add payment method agregas una tarjeta, que se procesa con Stripe. Agregarla no genera ningún cobro.
Compra créditos
En la misma sección, Buy more credits. Perplexity no publica un monto mínimo de compra.
Genera la llave
En la barra lateral izquierda, dentro de la sección del proyecto, entra a API keys y pulsa + Generate API Key (enlace directo: console.perplexity.ai/project/keys). Solo los administradores del grupo pueden gestionar llaves y facturación; si no ves la opción, pídele acceso a quien administra la cuenta.
Guárdala en una variable de entorno
Los ejemplos oficiales usan la variable
PERPLEXITY_API_KEY. Así la llave no aparece nunca en tu código.
# macOS / Linux export PERPLEXITY_API_KEY="tu_api_key" # Windows (PowerShell) setx PERPLEXITY_API_KEY "tu_api_key"
Reemplaza tu_api_key por la llave que generaste. En Windows, la variable queda disponible en las terminales que abras después.
Cómo se pagan los créditos de la API de Perplexity
Perplexity cobra por uso en todas sus API, sin suscripción: «Pay-as-you-go pricing for all APIs. No subscription required». Compras créditos por adelantado y se descuentan con cada llamada.
- Recarga automática: se activa con «Auto reload» en Billing (Change preferences). Según la ayuda de Perplexity, repone el saldo cuando baja de USD 2.
- Si se acaban los créditos, las llaves se bloquean hasta que recargues.
- Reembolsos: si reportas el problema dentro de los 14 días siguientes a la compra. Los créditos usados no se reembolsan.
- Monto mínimo: no está publicado.
Niveles de uso de la API de Perplexity
Los niveles dependen de lo que has comprado en total. Suben solos y no bajan:
| Nivel | Compras acumuladas |
|---|---|
| Tier 0 | USD 0 (cuentas nuevas, acceso limitado) |
| Tier 1 | USD 50 o más |
| Tier 2 | USD 250 o más |
| Tier 3 | USD 500 o más |
| Tier 4 | USD 1.000 o más |
| Tier 5 | USD 5.000 o más |
Precio de la API de Perplexity: depende de la API que uses
No hay un precio único. Cada API se cobra distinto, y el mismo modelo puede costar diferente según por dónde lo llames. Esto es lo que publica la página oficial de precios, a octubre de 2026.
Agent API
Pagas los tokens del preset o del modelo que elijas, más USD 0,0025 por cada uso de la herramienta web_search (USD 0,001 con Fast Search). En su tabla, el modelo perplexity/sonar figura a USD 0,25 por millón de tokens de entrada y USD 2,50 por millón de salida.
Sonar API
Se cobra por tokens más una tarifa por cada 1.000 solicitudes, que cambia según el contexto de búsqueda (bajo, medio o alto). En USD:
| Modelo | Entrada / 1M tokens | Salida / 1M tokens | Por 1.000 solicitudes (bajo / medio / alto) |
|---|---|---|---|
sonar | 1 | 1 | 5 / 8 / 12 |
sonar-pro | 3 | 15 | 6 / 10 / 14 |
sonar-reasoning-pro | 2 | 8 | 6 / 10 / 14 |
sonar-deep-research no tiene tarifa por solicitud: cobra USD 2 por millón de tokens de entrada y USD 8 de salida, más citas (USD 2 por millón), razonamiento (USD 3 por millón) y búsquedas (USD 5 por cada 1.000).
Search API
USD 5 por cada 1.000 solicitudes, o USD 1 por cada 1.000 en modo Fast.
¿Quieres que tu equipo deje flujos con IA funcionando?
En el curso cada área aprende a detectar qué automatizar, diseñar el flujo y dejarlo andando con las herramientas que ya tiene, con una persona que aprueba donde importa.
Ver el curso de automatización de procesos con IA →Tu primera llamada a la API de Perplexity
Estos son los ejemplos del quickstart oficial, copiados tal cual. Para el Agent API, instala el SDK de Perplexity (su librería oficial para Python):
pip install perplexityai
from perplexity import Perplexity
client = Perplexity()
response = client.responses.create(
preset="low",
input="Summarize the core findings of the original 'Attention Is All You Need' transformer paper and explain why it changed NLP.",
)
print(response.output_text)El cliente se crea sin pasarle la llave como parámetro: la toma de la variable PERPLEXITY_API_KEY que guardaste antes.
Si ya usas la librería de OpenAI
La documentación de Perplexity dice que su API «supports the OpenAI Chat Completions format» y que pasar código existente «is a base-URL change». Este es el ejemplo oficial contra la Orchestrator API:
from openai import OpenAI
import os
client = OpenAI(
api_key=os.environ.get("PERPLEXITY_API_KEY"),
base_url="https://api.perplexity.ai/router/v1"
)
response = client.chat.completions.create(
model="perplexity/kimi-k3",
max_tokens=1024,
messages=[
{"role": "user", "content": "Summarize the key trade-offs between vector and keyword search."}
]
)
print(response.choices[0].message.content)Cuidado con la base URL, porque cada API tiene la suya. La Orchestrator usa https://api.perplexity.ai/router/v1, en formato Chat Completions. El Agent API usa https://api.perplexity.ai/v1, en formato Responses, y no responde en /v1/chat/completions. La Sonar usa https://api.perplexity.ai.
Seguridad y datos: lo que conviene saber
- La llave es un secreto. Nunca en el código ni en un repositorio público: en una variable de entorno o en un gestor de secretos.
- Define quién administra. Solo los administradores del grupo gestionan llaves y facturación, así que esa persona tiene que estar clara desde el principio.
- Una llave por integración. Si una se expone, la revocas sin tumbar las demás.
- Datos: la FAQ de la API dice que aplica «zero day retention» y que no entrenan con los datos que envías.
Errores comunes con la API de Perplexity
- Dar por hecho que Pro incluye la API. Hoy no hay página oficial que lo confirme.
- Seguir con Sonar Chat Completions. Su soporte terminó el 27 de septiembre de 2026.
- Apuntar la librería de OpenAI a la base URL equivocada. El Agent API no sirve
/v1/chat/completions. - Quedarse sin saldo en producción. Las llaves se bloquean y el flujo se detiene.
- Comparar el precio de sonar entre API distintas. Son productos distintos.
- Buscar la llave en perplexity.ai/settings/api. Hoy todo vive en console.perplexity.ai.
- No ser administrador del grupo y no encontrar dónde generar la llave.
Cómo usa una empresa la API de Perplexity
Perplexity tiene sentido cuando un flujo necesita información actual de la web: vigilar a la competencia, resumir noticias del sector o completar fichas de prospectos con datos públicos. La parte difícil no es la llave. Es decidir qué se automatiza, qué información sale de la empresa y quién revisa el resultado antes de usarlo.
Eso es criterio de equipo, y se entrena. En PorContar damos capacitación en IA para empresas sobre el trabajo real de cada área:
- Para dejar procesos funcionando con IA conectada a las herramientas del área: el curso de automatización de procesos con IA.
- Para el equipo de tecnología que integra modelos en su código: Claude Code para equipos de tecnología.
- Si aprendes por tu cuenta: los cursos de IA para personas.
Si en tu empresa también evalúan otros proveedores, mira cómo obtener la OpenAI API key y la Claude API key.
¿Por dónde empieza tu equipo con la IA?
El diagnóstico es gratuito y toma dos minutos: ves en qué nivel de adopción está tu equipo y qué conviene hacer primero.
Hacer el diagnóstico de IA →Sigue aprendiendo con nuestros cursos
Domina Claude para Negocios
MarketingEstrategia de Marketing con IA
ContenidoStorytelling con IA y Creación de Contenido
Preguntas frecuentes
¿Qué es la API de Perplexity?
¿Dónde se obtiene la API key de Perplexity?
¿La API de Perplexity es gratis?
¿Cuánto cuesta la API de Perplexity?
¿La suscripción Pro de Perplexity incluye créditos de API?
¿Sonar sigue funcionando?
¿Puedo usar la librería de OpenAI con Perplexity?
¿Qué pasa si se acaban los créditos?
Datos verificados el 17 de octubre de 2026 en la documentación oficial de Perplexity: quickstart, precios, niveles de uso, changelog y ayuda de facturación de la API · Revisión trimestral
