Cómo usar la API de video a audio de YouTube

Tienes una URL de YouTube, necesitas un enlace MP3 y lo necesitas en producción esta semana. Al final de este artículo sabrás exactamente cómo llamar a un único endpoint que convierte un video de YouTube (≈5 minutos o menos) en un archivo de audio, analizar la respuesta y enviarlo detrás de una bandera de características.

Qué hace esta API y cuándo usarla

La API de video a audio de YouTube convierte un video de YouTube en un archivo de audio y devuelve un enlace descargable más metadatos básicos. Los flujos de trabajo de medios típicos que se benefician de esto incluyen:

Ilustración: Cómo usar la API de video a audio de YouTube

Extracción de audio para segmentos de podcast, intros/outros o resúmenes.
Generación de vistas previas solo de audio para bibliotecas de contenido.
Preparación de pistas de voz para transcripción o procesos de moderación.
Construcción de herramientas internas que agregan medios de formato corto en listas de reproducción de audio.

La API está disponible en Zyla API Hub, que proporciona una única cuenta, una clave API y un modelo de facturación de suscripción + cuota a través de miles de APIs. Para este listado, puedes comenzar una prueba de 7 días en la página del producto.

Comenzando en Zyla API Hub

Abre la página de la API, haz clic en Suscribirse o Comenzar prueba gratuita cuando esté disponible, y copia tu clave API desde el panel de control. Todas las solicitudes utilizan el encabezado de Autorización con un token Bearer.

Comienza la prueba de 7 días en la API de video a audio de YouTube

Autenticación: Authorization: Bearer YOUR_API_KEY
Facturación: suscripción + cuota (no pago por llamada). Consulta la página de la API para opciones de acceso y precios actuales.

Descripción general del endpoint

Esta API expone un único endpoint que puedes configurar rápidamente:

Obtener Audio (GET) — convierte un video de YouTube especificado a audio y devuelve un enlace y metadatos.

Obtener Audio

Método: GET
URL: https://zylalabs.com/api/1812/youtube-video-to-audio-api/5870/get-audio
Parámetro de consulta requerido:
- id (string): El ID del video de YouTube a convertir. Ejemplo: p-Z3YrHJ1sU
Nota: Los videos deben tener aproximadamente 5 minutos o menos de duración.

cURL: una solicitud que hace el trabajo

Copia, pega, ejecuta. Reemplaza YOUR_API_KEY con tu clave si deseas probar de inmediato.

curl -s -X GET "https://zylalabs.com/api/1812/youtube-video-to-audio-api/5870/get-audio?id=p-Z3YrHJ1sU"
-H "Authorization: Bearer YOUR_API_KEY"

Ejemplo de respuesta oficial

{
"link": "https://eta.123tokyo.xyz/get.php/9/9e/ty7nkwYqodA.mp3?cid=MmEwMTo0Zjg6YzAxMjozMmVlOjoxfE5BfERF&h=FwrcvY5cIfOO0jyXh5C-6Q&s=1737705748&n=%E2%82%B91%2C07%2C000%20_iPhone%2016%20Pro%20Max_%20USA%20to%20INDIA_%20%23shorts%20%23youtubeshorts&uT=R&uN=QWxlam9aeWxhTGFicw%3D%3D",
"title": "₹1,07,000 *iPhone 16 Pro Max* USA to INDIA! #shorts #youtubeshorts",
"filesize": 417480,
"progress": 100,
"duration": 22.896054233758,
"status": "ok",
"msg": "success"
}

Aspectos destacados de los campos que realmente usarás:

link: URL directa al archivo de audio generado. Usa esto para descargar o transmitir.
title: Título del video de YouTube fuente (útil para nombres de archivos o etiquetas de UI).
filesize: Tamaño del archivo de audio (valor numérico devuelto por la API).
duration: Duración del clip de audio (valor numérico devuelto por la API).
progress: 100 indica que el audio está listo para descargar.
status y msg: Verificación rápida de éxito/error.

Ejemplo en Python: obtener y persistir la URL de audio

Este ejemplo llama al mismo endpoint, valida el estado/progreso e imprime el enlace de audio y los metadatos. Es mínimo por diseño para que puedas pegarlo en un script o trabajo.

import os
import requests

API_KEY = os.getenv("ZYLALABS_API_KEY", "YOUR_API_KEY")
VIDEO_ID = "p-Z3YrHJ1sU"

url = "https://zylalabs.com/api/1812/youtube-video-to-audio-api/5870/get-audio"
headers = {
"Authorization": f"Bearer {API_KEY}"
}
params = {
"id": VIDEO_ID
}

resp = requests.get(url, headers=headers, params=params, timeout=60)
resp.raise_for_status()
data = resp.json()

# Comprobaciones básicas de salud
if data.get("status") != "ok" or data.get("progress") != 100:
raise SystemExit(f"Conversión no lista o fallida: {data}")

audio_link = data.get("link")
title = data.get("title")
duration = data.get("duration")
filesize = data.get("filesize")

print("URL de audio:", audio_link)
print("Título:", title)
print("Duración:", duration)
print("Tamaño del archivo:", filesize)

# Opcional: descargar a un archivo local (streaming)
if audio_link:
r = requests.get(audio_link, stream=True, timeout=120)
r.raise_for_status()
# Derivar un nombre de archivo simple del título; personaliza según sea necesario.
filename = "output.mp3"
with open(filename, "wb") as f:
for chunk in r.iter_content(chunk_size=8192):
if chunk:
f.write(chunk)
print("Guardado:", filename)

Notas de integración en el mundo real

Duración del video: El endpoint está diseñado para videos de aproximadamente 5 minutos o menos. Aplica esta restricción en tu UI o capa de trabajo antes de llamar a la API.
Idempotencia por ID de YouTube: Si esperas solicitudes repetidas para el mismo clip, almacena en caché por el ID del video de YouTube. También puedes persistir el enlace devuelto si tu flujo de trabajo descarga de inmediato.
Manejo de progreso: La respuesta incluye un campo de progreso. En el ejemplo mostrado es 100 cuando el audio está disponible. Para flujos simples, llama una vez y procede cuando el progreso sea igual a 100.
Reintentos y retroceso: Para trabajos en segundo plano, agrega reintentos en errores de red transitorios al llamar al endpoint de Zyla Hub y al descargar desde el enlace devuelto.
Manejo de contenido: Usa el campo título para etiquetar archivos o filas de UI. Sanitiza para nombres de archivos al escribir en disco.

Casos de uso que puedes implementar rápidamente

Botones de clip a audio en herramientas editoriales: Pega un ID de YouTube, haz clic en Convertir, recibe un URL de streaming de vuelta.
Generación automática de vistas previas: Para envíos de medios cortos, convierte a audio para colas de moderación rápidas.
Archivista de audio para contenido de formato corto: Ingiere periódicamente un conjunto de IDs de videos de canal y almacena artefactos de audio.
Preprocesamiento de transcripción: Convierte videos cortos a audio antes de pasarlos a tu pipeline de voz a texto.

Llamadas a través de agentes de IA usando MCP

Si usas Claude Code, Cursor, Windsurf u otro cliente compatible con MCP, puedes permitir que el agente llame a las APIs de Zyla enrutando solicitudes a través de la puerta de enlace MCP. Apunta el cliente al endpoint MCP y pasa tu clave API:

Puerta de enlace: https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY

Desde allí, instruye a tu agente para que haga una solicitud GET al endpoint exacto del Hub mostrado arriba, incluye el encabezado de Autorización con tu clave y proporciona el parámetro de consulta id. Por seguridad, guarda tu clave API en el almacén secreto del agente y evita registrar encabezados sensibles.

MCP

Consejos operativos

Encabezados: Siempre envía Authorization: Bearer YOUR_API_KEY al endpoint de Zyla Hub.
Timeouts: El tiempo de red varía; configura timeouts razonables tanto para la llamada a la API como para la descarga del archivo subsiguiente.
Almacenamiento: Si necesitas acceso persistente, descarga el archivo cuando recibas el enlace y guárdalo en tu bucket de almacenamiento. No asumas que los enlaces de terceros son permanentes.
Monitoreo: Registra valores de estado, msg y progreso para detectar fallos temprano en trabajadores de lotes o colas.
Cuotas: El hub utiliza un modelo de suscripción + cuota. Realiza un seguimiento de tu uso; si esperas picos, revisa tu plan en la página de listado.

Flujo de extremo a extremo que puedes implementar hoy

Obtén una clave API de la página de listado y guárdala en tu configuración o administrador de secretos.
Acepta un ID de video de YouTube en tu UI o cola de trabajo. Valida las restricciones de longitud en la parte superior cuando puedas.
Llama a GET https://zylalabs.com/api/1812/youtube-video-to-audio-api/5870/get-audio con el parámetro id y el encabezado de Autorización.
Verifica que status == "ok" y progress == 100.
Consume el enlace para descargar o transmitir. Guarda en tu almacenamiento si necesitas acceso duradero.
Usa title, duration y filesize para UI, registro y señales de QA.

FAQ

¿Qué parámetro debo pasar para convertir un video?
Pasa el ID del video de YouTube usando el parámetro de consulta id (ejemplo: p-Z3YrHJ1sU) al endpoint Obtener Audio.

¿Cuál es la URL y el método del endpoint?
GET https://zylalabs.com/api/1812/youtube-video-to-audio-api/5870/get-audio

¿Cómo me autentico?
Incluye el encabezado Authorization: Bearer YOUR_API_KEY en cada solicitud al endpoint de Zyla Hub.

¿Hay un límite de duración de video?
Sí. Los videos deben tener aproximadamente 5 minutos o menos de duración.

¿Qué significa el progreso?
La respuesta incluye un campo de progreso numérico. Un valor de 100 indica que el audio está listo para descargar.

Envíalo

Solo necesitas una solicitud GET para convertir un ID de video de YouTube en un enlace de audio descargable. Crea tu cuenta, obtén una clave API y conéctala a tu flujo de trabajo de medios hoy a través de la página de listado: Comienza la prueba de 7 días en la API de video a audio de YouTube.