Notas de episodio
Las notas del episodio son el último trámite entre una grabación terminada y un episodio publicado, y es la parte que casi todos los conductores apuran. Este endpoint escucha el episodio completo y escribe un resumen, los puntos clave y citas destacadas listos para pegar en la descripción del podcast o en el blog.
Ejecútela online
Ejecute esto en nuestros servidores con su cuenta. Las herramientas gratuitas corren en su navegador; esta cobra de su saldo del KIT según el precio de arriba.
El cuello de botella que reemplaza
Escribir buenas notas de episodio implica volver a escuchar una hora de audio, decidir qué importa de verdad y redactarlo para que un desconocido que hojea una app de podcasts decida darle play. La mayoría de los conductores independientes se saltan este paso por completo, publicando solo un título, o lo delegan y esperan días por un borrador. Ninguna de las dos opciones encaja con un calendario semanal, y ese es el problema que resuelve este endpoint.
Cómo luce el resultado
Llame a POST /audio/show-notes con el audio del episodio y la tarea devuelve un texto estructurado: un resumen breve del episodio, una lista ordenada de los puntos clave y varias citas destacables listas para resaltar. Como corre de forma asíncrona, envía el archivo y sigue con lo suyo: las notas terminadas llegan a su webhook, o esperan en un enlace firmado durante 24 horas si prefiere recogerlas usted mismo.
Un formato moldeado por cómo se descubren los podcasts
Los directorios de podcasts y los buscadores indexan las descripciones de episodio como texto plano, y por eso las notas de episodio adoptaron una forma predecible: un gancho, varios puntos con viñetas y a veces una cita destacada cerca del inicio. Esa convención existe porque funciona para lectura rápida, y es la forma que persigue este endpoint en lugar de un párrafo suelto que entierra la información útil.
A quién le ahorra más tiempo
Los conductores que graban, editan y publican en solitario son quienes más lo sienten, porque las notas suelen ser la tarea que se sacrifica cuando el tiempo apremia. Las redes que producen varios programas lo usan para mantener el tono y la extensión de las notas consistentes entre conductores que escriben de forma muy distinta a mano.
Cómo encaja en un flujo de publicación
Combina naturalmente con la API Capítulos de Podcast, que aporta las marcas de tiempo del mismo episodio; juntas entregan notas y navegación a partir de un solo archivo de audio, listas para publicar apenas termina la edición en lugar de uno o dos días después.
Qué puede hacer con ella
Podcasts semanales en solitario
Genere la descripción apenas se exporta el episodio, para que publicar ya no dependa de encontrar tiempo para escribir notas a mano.
Programas de entrevistas
Convierta una conversación larga en un resumen fácil de hojear y una lista de citas que le da a un oyente potencial una razón para darle play.
Redes de podcasts
Estandarice las notas de episodio entre varios conductores y programas sin pedirle a cada uno que escriba manualmente en el mismo estilo.
Migración de archivo histórico
Rellene las notas de episodios antiguos que se publicaron solo con un título, mejorando cómo aparecen en las búsquedas de podcasts.
Preguntas frecuentes
¿Qué obtengo exactamente con la API para generar notas de podcast?
Un resumen, una lista ordenada de puntos clave y citas destacadas del episodio, estructurados para pegarse directamente en la descripción de un podcast o en una entrada de blog.
¿Necesito enviar la transcripción por separado?
No, envía el audio y el paso de transcripción ocurre internamente como parte de la tarea, así que no hay que preparar nada de antemano.
¿Se puede probar gratis?
No hay capa gratuita: las capas gratis se abusan y ralentizan a todos. El acceso funciona con un saldo prepago de ForHosting KIT: se recarga desde $10.00 (no caduca) y cada solicitud se cobra a su precio publicado, así que una llamada sin saldo devuelve HTTP 402. Sin suscripción, sin tokens ni créditos inventados, y una tarea fallida no se cobra.
¿Cómo se calcula el precio?
Una tarifa base por solicitud más una tarifa por minuto de audio, ambas publicadas en esta página, sin ningún cobro para una tarea que falla tras los reintentos.
¿Cuánto tarda en procesarse un episodio?
El tiempo de proceso escala con la duración del audio porque la tarea es asíncrona; se le avisa por webhook en cuanto las notas están listas, sin necesidad de mantener una conexión abierta.
¿Funciona con episodios en idiomas distintos del inglés?
El endpoint cubre el mismo rango de idiomas hablados que el resto de la suite de audio, así que los programas multilingües funcionan sin configuración aparte.
¿Las notas necesitan edición antes de publicar?
Trátelas como un borrador sólido, no como el texto final: la mayoría de los conductores hace un ajuste ligero de tono antes de publicar, porque la estructura y el contenido ya están resueltos.
¿Se guarda el audio del episodio después?
No, el audio se elimina tras el período de retención y nunca se usa para entrenar modelos, así que nada de su episodio persiste más allá de generar las notas.
Para desarrolladores — acceso por API
Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.
Endpoint de API
¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, y pronto desde nuestra app, el email y Telegram.
Llámela desde su stack
curl -X POST https://api.kit.forhosting.com/audio/show-notes \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"audio":"https://ejemplo.com/audio.mp3"}'const res = await fetch("https://api.kit.forhosting.com/audio/show-notes", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"audio": "https://ejemplo.com/audio.mp3"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/audio/show-notes",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"audio": "https://ejemplo.com/audio.mp3"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/audio/show-notes", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"audio":"https://ejemplo.com/audio.mp3"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"audio":"https://ejemplo.com/audio.mp3"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/audio/show-notes", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Ejemplo de solicitud
{
"audio": "https://ejemplo.com/audio.mp3"
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "audio.show_notes",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.
Precio
Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.
Límites
max_mb | 200 |
max_minutes | 180 |
Errores
| HTTP | Código | Significado |
|---|---|---|
401 | unauthorized | API key ausente o inválida. |
402 | insufficient_balance | El saldo no cubre el precio de la tarea. |
404 | unknown_type | El tipo de tarea no existe. |
429 | rate_limited | Demasiadas peticiones. Use el webhook en vez de sondear. |
422 | task_failed | La tarea falló tras 3 reintentos. No se cobra. |