← Blog  /  ■ Herramientas IA

Perplexity API: cómo obtener la API key y empezar a usarla

La API de Perplexity cambió mucho en 2026. Sonar ya no es la puerta principal, el precio depende de la API que elijas y la suscripción Pro no resuelve la factura. Esto es lo vigente.

Por Luisa Navarro · 18/10/2026 · 9 min de lectura

Luisa Navarro es cofundadora de PorContar, ingeniera industrial, magíster en Big Data y magíster en inteligencia artificial. Enseña a equipos de empresa a llevar la IA a sus procesos reales.

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, high o xhigh) 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.
En cortoSi vas a empezar hoy, empieza por el Agent API. Es la que Perplexity recomienda para proyectos nuevos.

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

  1. 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í.

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

  3. Compra créditos

    En la misma sección, Buy more credits. Perplexity no publica un monto mínimo de compra.

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

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

Variable de entorno
# 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.
Decide antes de producción: un flujo sin recarga automática se detiene el día que se acaba el saldo, porque las llaves se bloquean. Uno con recarga y sin nadie mirando puede gastar de más. Elige cuál riesgo prefieres y asigna a una persona que revise el consumo cada semana.

Niveles de uso de la API de Perplexity

Los niveles dependen de lo que has comprado en total. Suben solos y no bajan:

NivelCompras acumuladas
Tier 0USD 0 (cuentas nuevas, acceso limitado)
Tier 1USD 50 o más
Tier 2USD 250 o más
Tier 3USD 500 o más
Tier 4USD 1.000 o más
Tier 5USD 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:

ModeloEntrada / 1M tokensSalida / 1M tokensPor 1.000 solicitudes (bajo / medio / alto)
sonar115 / 8 / 12
sonar-pro3156 / 10 / 14
sonar-reasoning-pro286 / 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).

USD 5 por cada 1.000 solicitudes, o USD 1 por cada 1.000 en modo Fast.

No compares peras con manzanas: el modelo sonar aparece a USD 0,25 / USD 2,50 en el Agent API y a USD 1 / USD 1, más tarifa por solicitud, en la Sonar API. No es un error de lectura: son dos productos con tarifas distintas. Los precios de la Sonar API salen de la página oficial de precios, y como esa API está en transición hacia el Agent API, confírmalos el día que vayas a presupuestar.

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

Instalación
pip install perplexityai
Python · Agent API · quickstart oficial
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:

Python · SDK de OpenAI contra la Orchestrator API · quickstart oficial
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:

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 →

Preguntas frecuentes

¿Qué es la API de Perplexity?
Es el acceso para usar desde tus propios sistemas las respuestas con búsqueda web de Perplexity. A octubre de 2026 incluye varias API: el Agent API, que Perplexity recomienda para proyectos nuevos, la Orchestrator API, la Sonar API, la Search API, Embeddings y Decisions API.
¿Dónde se obtiene la API key de Perplexity?
En la consola de la API, console.perplexity.ai. En la barra lateral, dentro de la sección del proyecto, entras a API keys y pulsas + Generate API Key. Solo los administradores del grupo pueden gestionar llaves y facturación.
¿La API de Perplexity es gratis?
No. Todas sus API se pagan por uso con créditos que compras por adelantado, y no hace falta suscripción. Perplexity no publica un monto mínimo de compra.
¿Cuánto cuesta la API de Perplexity?
Depende de la API. En el Agent API pagas los tokens del modelo o preset que elijas más USD 0,0025 por cada búsqueda web; la Search API cuesta USD 5 por cada 1.000 solicitudes; la Sonar API cobra tokens más una tarifa por solicitud. Son precios a octubre de 2026 de la página oficial.
¿La suscripción Pro de Perplexity incluye créditos de API?
Hoy ninguna página oficial de Perplexity lo confirma. Su ayuda de facturación dice que la API es un servicio aparte, disponible para todos los usuarios y sin suscripción obligatoria.
¿Sonar sigue funcionando?
La Sonar API sigue documentada, pero el soporte de Sonar Chat Completions terminó el 27 de septiembre de 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.
¿Puedo usar la librería de OpenAI con Perplexity?
Sí. Perplexity acepta el formato Chat Completions de OpenAI y dice que pasar código existente es un cambio de base URL. Ojo: cada API tiene su propia base URL, y el Agent API no responde en /v1/chat/completions.
¿Qué pasa si se acaban los créditos?
Las llaves se bloquean hasta que recargues. Para evitarlo existe la recarga automática en Billing, que según la ayuda de Perplexity repone el saldo cuando baja de USD 2.

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

¿Te sirvió? Esto llega cada semana

Guías como esta, casos y estrategias de IA para tu negocio. Gratis y directo al grano.

Más guías de API

Más
Hablemos en WhatsAppDiagnóstico