Cómo generar pódcasts con la API de Podhoc: guía completa
Genera pódcasts con IA mediante la API REST de Podhoc. Autenticación, ciclo crear-consultar-descargar, límites de tasa y estimación de créditos.
Para crear o rotar tokens de prueba o producción necesitas Pro activo o en prueba. Los tokens de prueba gastan créditos reales; no es un entorno gratuito. Guarda las claves en el servidor, fuera del navegador, URL, registros y repositorios.
Las fuentes deben ser URL públicas compatibles. La API no acepta archivos subidos ni texto pegado. No publiques documentos confidenciales para usarla.
Primera petición segura
El ejemplo usa una fuente pública ficticia. Genera audio y gasta créditos: consulta saldo y estimación y aprueba un presupuesto. Cinco minutos con una voz cuestan 72 créditos con el multiplicador de prueba predeterminado; usa la estimación recibida si cambia la configuración.
Guarda un Idempotency-Key nuevo para cada generación deseada antes de enviar. Si la respuesta es incierta, repite la misma clave y contenido. Se devuelve el recibo original; cambiar el contenido con esa clave da 409. Un timeout no justifica inventar otra clave.
Límites y precios
Prueba: 2 peticiones/minuto, 20/hora, 1 generación simultánea, hasta 5 minutos, 1 URL e inglés. Producción: 30/minuto, 300/hora y 5 generaciones simultáneas, según límites Pro. Respeta Retry-After ante 429.
Base: max(36, ceil(minutos × 10 / 3)). Varias fuentes añaden 27 créditos; pesos personalizados, 13; varias voces estándar multiplican el subtotal por 1,2, con redondeo y límite aplicable. Después se aplica el multiplicador API: 2× prueba y 3,5× producción por defecto. La configuración puede variar. Treinta minutos con una fuente y voz: 100 × 3,5 = 350 créditos en producción. Un token de prueba no permite 30 minutos.
Usa estimate-cost con los mismos ajustes y revisa final_credits y credit_multiplier. Comprueba el saldo restante antes de aprobar. La duración es aproximada; el coste corresponde a los ajustes solicitados, no al cronómetro del audio final.
Estado, descarga y errores
Con tokens de prueba consulta cada 240 segundos como máximo, hasta 12 veces, reservando capacidad para otras peticiones. En producción usa esperas limitadas y respeta las cabeceras. Si sigue pendiente, guarda el ID y vuelve después; no dupliques la creación. Este documento no promete un webhook de finalización.
Descarga solo al llegar a completed. Un fallo debe mostrar un motivo final; revisa el saldo y reembolso antes de otro intento. La URL de descarga es temporal y privada: no la publiques ni la guardes como dirección permanente.
Privacidad, publicación y borrado
El resultado es público por defecto. Creator y Pro permiten elegir privado antes de generar; los episodios privados se pueden publicar después confirmando los derechos. La API de producción respeta la elección del propietario suscrito; los tokens de prueba no pueden publicar. Para crear en privado, envía explícitamente auto_publish=false con tu cuenta Pro.