API de Brevecast — Documentación para Desarrolladores

¿Qué es Brevecast?

Brevecast es una API REST que toma podcasts de hasta 3 horas y genera un resumen ejecutivo en texto + un audio narrado con lo más importante. Ideal para mantenerte al día sin escuchar horas.

Acepta URLs de RSS de podcast o enlaces directos a MP3. El procesamiento es asíncrono: envías la URL, recibes un job_id, y consultas el estado hasta que esté listo.

Gratis: 3 resúmenes/mes (podcasts hasta 30 min). Pro ($5/mes): Ilimitado hasta 3 horas. Lifetime ($39): Acceso Pro de por vida.

Autenticación

No se requiere API key para el tier gratuito. Los límites se aplican por IP.

Para Pro/Lifetime, envía tu API key:

Authorization: Bearer tu-api-key

Endpoints

Método	Ruta	Descripción
`POST`	/v1/summarize	Resumir podcast desde URL (RSS o MP3)
`GET`	/jobs/{job_id}	Estado del job de resumen
`GET`	/pricing	Planes y precios (JSON)
`GET`	/stats	Estadísticas públicas

Ejemplos de uso

Resumir un episodio de podcast

Envía la URL del MP3 o feed RSS y recibe un job_id para consultar después.

curl -X POST https://brevecast.4l3.org/v1/summarize \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://ejemplo.com/podcast/ep42.mp3",
    "voice": "es-MX-Ald"
  }'

import requests
import time

# 1. Enviar podcast
response = requests.post(
    "https://brevecast.4l3.org/v1/summarize",
    json={
        "url": "https://ejemplo.com/podcast/ep42.mp3",
        "voice": "es-MX-Ald",
    },
)
job = response.json()
print(f"Job: {job['job_id']}")

# 2. Consultar estado
while True:
    status = requests.get(
        f"https://brevecast.4l3.org/jobs/{job['job_id']}"
    ).json()
    if status["status"] == "completed":
        break
    time.sleep(10)

print(f"Resumen: {status['summary_text']}")
print(f"Audio: {status['audio_url']}")

const response = await fetch("https://brevecast.4l3.org/v1/summarize", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    url: "https://ejemplo.com/podcast/ep42.mp3",
    voice: "es-MX-Ald",
  }),
});
const { job_id } = await response.json();
console.log(`Job: ${job_id}`);

// Consultar estado después
const status = await fetch(`https://brevecast.4l3.org/jobs/${job_id}`)
  .then(r => r.json());
console.log(status.summary_text);

Respuesta:

{
  "job_id": "brv_abc123",
  "status": "processing",
  "title": "Episodio 42: El futuro de la IA",
  "estimated_seconds": 120
}

Consultar estado del resumen

Usa el job_id para verificar si el resumen está listo.

curl https://brevecast.4l3.org/jobs/brv_abc123

import requests

status = requests.get(
    "https://brevecast.4l3.org/jobs/brv_abc123"
).json()
if status["status"] == "completed":
    print(status["summary_text"])
    print(f"Audio: {status['audio_url']}")

const status = await fetch("https://brevecast.4l3.org/jobs/brv_abc123")
  .then(r => r.json());
if (status.status === "completed") {
  console.log(status.summary_text);
}

Respuesta:

{
  "job_id": "brv_abc123",
  "status": "completed",
  "title": "Episodio 42: El futuro de la IA",
  "summary_text": "En este episodio se discuten 3 tendencias clave...",
  "audio_url": "/audio/brv_abc123.mp3",
  "original_duration_s": 2340,
  "summary_duration_s": 180
}

Probar la API

Haz llamadas reales a la API directamente desde aqui. Sin API key necesaria para el plan gratuito.

POST /v1/summarize Resumir audio desde URL

Límites de uso

Free (sin registro): 3 resúmenes/mes. Podcasts hasta 30 minutos.

Pro ($5/mes): Resúmenes ilimitados. Hasta 3 horas por episodio.

Lifetime ($39): Igual que Pro, pago único de por vida.

SDK Python

Instala el SDK oficial y úsalo en 3 líneas:

pip install brevecast

Ejemplo:

from brevecast import Brevecast

client = Brevecast()  # Free tier, no API key needed

result = client.summarize("https://podcast.example.com/ep.mp3")
print(result["summary_text"])

Paquete: brevecast · Compatible con Python 3.8+

Recursos API

Descarga la especificación para tu herramienta favorita:

OpenAPI 3.1 (JSON) Swagger UI

Compatible con Postman, Insomnia, Swagger, y cualquier cliente OpenAPI.

Empieza gratis

No necesitas API key para empezar. Simplemente haz tu primera llamada:

curl https://brevecast.4l3.org/api?format=json

Ir a Brevecast Ver planes

¿Prefieres JSON? Llama este URL con Accept: application/json o agrega ?format=json.