Tu tarea: toma un enlace de YouTube o un ID de video y obtén programáticamente una URL de MP3 descargable que puedas guardar o transmitir en tu aplicación. Al final de este artículo, llamarás a un endpoint real que devuelve un enlace de audio directo y metadatos, y luego escribirás unas líneas de código para descargar el archivo.
Lo que puedes construir con esto
La API de Youtube a Audio en Zyla API Hub te permite transformar un video de YouTube en una URL de descarga de audio. Devuelve un enlace al archivo de audio junto con metadatos útiles como título, duración y tamaño del archivo. Los desarrolladores la utilizan para:
- Generar MP3s de videos públicos de YouTube para reproducción sin conexión en una aplicación de podcasting o aprendizaje.
- Colocar trabajos de extracción de audio como parte de un flujo de trabajo de medios más grande.
- Simplificar la ingestión de contenido devolviendo una única URL que puede ser descargada o proxyada por tu servicio.
Esta API se centra en dos acciones concretas: dado un ID de video, devuelve un enlace de audio y metadatos; o, dado una URL completa de YouTube, devuelve una URL lista para descargar. No hay SDK con el que luchar, solo simples llamadas HTTP GET.
Comenzando en Zyla API Hub
Zyla API Hub proporciona miles de APIs listas para producción a través de una cuenta, una clave API y un modelo de suscripción consistente. Puedes navegar, suscribirte y llamar a APIs sin configurar múltiples cuentas de proveedores. Explora más en zylalabs.com.
Para usar esta API:
- Abre la página Iniciar prueba de 7 días en la API de Youtube a Audio en Zyla API Hub.
- Haz clic en Suscribirse (o Iniciar prueba gratuita cuando esté disponible) y obtén tu clave API.
- Envía solicitudes con el encabezado Authorization: Bearer YOUR_API_KEY.
La facturación es por suscripción con cuota, no por llamada. Consulta la página de la API para las opciones de acceso y precios actuales. También puedes descubrir más APIs y categorías en zylalabs.com.
Descripción general de la API
La API de Youtube a Audio expone dos endpoints GET a través de la puerta de enlace API de Zyla:
- Obtener Audio (por ID de video de YouTube): devuelve un enlace de audio directo y metadatos
- Descargar Audio (por URL completa de YouTube): devuelve una URL de descarga
Todas las solicitudes utilizan HTTPS y requieren el encabezado de autorización con una clave API Bearer. Los ejemplos a continuación son copiables y pegables.
Endpoint: Obtener Audio (por ID de video)
Usa esto cuando tengas el ID de video de YouTube y necesites el enlace de audio más metadatos como título, duración y tamaño del archivo.
- Método: GET
- URL: https://zylalabs.com/api/381/youtube-to-audio-api/8884/get-audio
- Parámetro de consulta requerido: id
Ejemplo de solicitud:
curl -s -X GET "https://zylalabs.com/api/381/youtube-to-audio-api/8884/get-audio?id=xFYQQPAOz7Y" \
-H "Authorization: Bearer YOUR_API_KEY"
Ejemplo de respuesta JSON:
{
"msg": "success",
"link": "https://theta.123tokyo.xyz/get.php/d/fa/xFYQQPAOz7Y.mp3?n=Eminem%20-%20Lose%20Yourself&uT=R&uN=QWxlam9aeWxhTGFicw%3D%3D&h=TcO7xrzRPZ9cGbw2wXP93w&s=1784312338&uT=R&uN=QWxlam9aeWxhTGFicw%3D%3D",
"status": "ok",
"duration": 327.49718169275,
"title": "Eminem - Lose Yourself",
"progress": 100,
"pc": 0,
"filesize": 4181397
}
Notas sobre los campos que realmente usarás:
- link: URL directa al archivo de audio generado. Usa esto para transmitir o guardar el MP3.
- title: título del video fuente, útil para nombres de archivos y etiquetas de UI.
- duration: valor de punto flotante que representa la duración en segundos.
- filesize: tamaño en bytes para el audio descargable, lo que ayuda para las barras de progreso y la planificación de almacenamiento.
- status/msg/progress: indicadores de estado; progress es un número similar a un porcentaje en este ejemplo.
Ejemplo en Python: obtener enlace de audio y descargar MP3
Este ejemplo llama al endpoint Obtener Audio, extrae el campo de enlace y descarga el archivo en el disco. Reemplaza YOUR_API_KEY con tu clave de la página del mercado.
import os
import sys
import requests
API_KEY = os.getenv("ZYLA_API_KEY", "YOUR_API_KEY")
VIDEO_ID = "xFYQQPAOz7Y" # Proporcionado en la solicitud de ejemplo
try:
# Paso 1: Obtener metadatos de audio y enlace
meta_resp = requests.get(
"https://zylalabs.com/api/381/youtube-to-audio-api/8884/get-audio",
headers={"Authorization": f"Bearer {API_KEY}"},
params={"id": VIDEO_ID},
timeout=30,
)
meta_resp.raise_for_status()
data = meta_resp.json()
if data.get("status") != "ok" or "link" not in data:
print("Audio no listo o fallido:", data)
sys.exit(1)
audio_url = data["link"]
title = data.get("title", f"{VIDEO_ID}.mp3")
duration = data.get("duration")
size_bytes = data.get("filesize")
# Elegir un nombre de archivo. Si el título está presente, haz un nombre de archivo seguro.
filename = f"{title}.mp3" if not title.endswith(".mp3") else title
safe_filename = filename.replace("/", "_")
print(f"Descargando: {safe_filename}")
print(f"Duración (s): {duration}")
print(f"Tamaño del archivo (bytes): {size_bytes}")
print(f"URL: {audio_url}")
# Paso 2: Descargar el MP3
with requests.get(audio_url, stream=True, timeout=60) as r:
r.raise_for_status()
with open(safe_filename, "wb") as f:
for chunk in r.iter_content(chunk_size=8192):
if chunk:
f.write(chunk)
print("Guardado en:", safe_filename)
except requests.HTTPError as e:
print("Error HTTP:", e, file=sys.stderr)
sys.exit(1)
except requests.RequestException as e:
print("La solicitud falló:", e, file=sys.stderr)
sys.exit(1)
Consejo: dado que la respuesta incluye filesize, puedes preasignar barras de progreso. Si filesize no está disponible, transmite e infiere el progreso contando bytes a medida que escribes.
Endpoint: Descargar Audio (por URL completa de YouTube)
Usa esto cuando tengas una URL completa de video de YouTube y solo necesites una URL de descarga. Este endpoint devuelve un campo downloadUrl que puedes obtener en un segundo paso.
- Método: GET
- URL: https://zylalabs.com/api/381/youtube-to-audio-api/22174/download-audio
- Parámetro de consulta requerido: url
Ejemplo de solicitud:
Ejemplo de respuesta JSON:
En un flujo típico, llama a este endpoint para obtener downloadUrl, luego realiza un estándar HTTP GET en esa URL para recuperar el contenido de audio binario. Si necesitas título, duración o tamaño del archivo, prefiere el endpoint Obtener Audio que muestra esos campos junto con el enlace.
¿Qué endpoint deberías usar?
- Usa Obtener Audio cuando ya tengas el ID de video y quieras metadatos (título, duración, filesize) más el enlace en una respuesta.
- Usa Descargar Audio cuando tengas una URL completa de YouTube y solo necesites una URL descargable, luego obtén el archivo en una segunda solicitud.
Detalles de implementación que ahorran tiempo
- Autenticación: Siempre envía Authorization: Bearer YOUR_API_KEY. No pongas la clave en la cadena de consulta.
- Timeouts: Las llamadas son estándar HTTPS GET. Establece tiempos de espera prácticos tanto en la solicitud de metadatos como en la solicitud de descarga de archivos. La descarga de archivos puede tardar más; transmite con lecturas en fragmentos.
- Nombres de archivos: La respuesta de Obtener Audio incluye el título, que es conveniente para nombres de archivos. Sánalo para tu sistema operativo.
- Duraciones y tamaños: duration es un float en segundos; filesize son bytes. Usa filesize para presupuestar almacenamiento e indicadores de progreso.
- Cacheo: Si solicitas repetidamente el mismo ID de video o URL, almacena el enlace resultante y los metadatos en tu sistema con una política de caducidad que se ajuste a tu flujo de trabajo.
- Reintentos: Las solicitudes de red para el enlace de archivo devuelto atraviesan un host diferente al de la puerta de enlace Zyla. Si una descarga falla, reintenta con retroceso.
Ejemplo de extremo a extremo en JavaScript (Node.js)
Este script utiliza fetch para acceder al endpoint Obtener Audio, luego descarga el archivo utilizando el enlace devuelto. Usa Node 18+ o agrega un polyfill de fetch.
import fs from "node:fs";
import { pipeline } from "node:stream";
import { promisify } from "node:util";
const streamPipeline = promisify(pipeline);
const API_KEY = process.env.ZYLA_API_KEY || "YOUR_API_KEY";
const VIDEO_ID = "xFYQQPAOz7Y";
async function main() {
// Paso 1: Obtener metadatos + enlace
const metaUrl = new URL("https://zylalabs.com/api/381/youtube-to-audio-api/8884/get-audio");
metaUrl.searchParams.set("id", VIDEO_ID);
const metaResp = await fetch(metaUrl, {
method: "GET",
headers: { Authorization: `Bearer ${API_KEY}` },
});
if (!metaResp.ok) {
console.error("La solicitud de metadatos falló:", metaResp.status, await metaResp.text());
process.exit(1);
}
const data = await metaResp.json();
if (data.status !== "ok" || !data.link) {
console.error("Audio no listo o enlace faltante:", data);
process.exit(1);
}
const audioUrl = data.link;
const title = data.title || `${VIDEO_ID}.mp3`;
const filename = title.endsWith(".mp3") ? title : `${title}.mp3`;
console.log("Descargando:", filename);
console.log("Duración (s):", data.duration);
console.log("Tamaño del archivo (bytes):", data.filesize);
console.log("URL:", audioUrl);
// Paso 2: Descargar el archivo
const fileResp = await fetch(audioUrl, { method: "GET" });
if (!fileResp.ok || !fileResp.body) {
console.error("La descarga falló:", fileResp.status, await fileResp.text());
process.exit(1);
}
await streamPipeline(fileResp.body, fs.createWriteStream(filename));
console.log("Guardado en:", filename);
}
main().catch((err) => {
console.error(err);
process.exit(1);
});
Patrones del mundo real
- Procesamiento por lotes: Dada una lista de reproducción, resuelve cada video a su ID, luego llama a Obtener Audio para cada ID. Almacena título, filesize y enlace para tu pipeline de ingestión.
- Microlibrería para tu servicio: Envuelve estos dos endpoints en un pequeño ayudante con reintentos, tiempo de espera y saneamiento de nombres de archivos.
- Trabajos en segundo plano: Coloca conversiones de ID a audio utilizando tu ejecutor de trabajos. Si data.status o progress indican trabajo asincrónico en tu escenario, consulta hasta que progress sea 100 antes de descargar.
- Transferencia de almacenamiento: En lugar de servir el enlace externo directamente, descarga y vuelve a subir a tu propio almacenamiento de objetos para un alojamiento y control de acceso consistentes.
Llamando desde agentes de IA a través de MCP
Si estás conectando esto a un entorno de desarrollador de IA, puedes llamar a las APIs de Zyla a través del Protocolo de Contexto de Modelo utilizando un único endpoint MCP. Cualquier cliente compatible con MCP (por ejemplo, Claude Code, Cursor, Windsurf) puede invocar APIs del mercado a través de:
Endpoint para agentes: https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY
Usa tu clave API de Zyla con el parámetro de consulta apikey en ese endpoint MCP, luego haz que tu agente realice las mismas llamadas HTTPS que se muestran arriba a través de su transporte MCP. Para información general sobre MCP, consulta la página MCP.
Lista de verificación de solución de problemas
- Errores 401 o 403: Asegúrate de que el encabezado Authorization esté configurado como Bearer YOUR_API_KEY y que tu suscripción esté activa.
- Sin enlace en la respuesta: Para el endpoint Obtener Audio, verifica los campos de estado y progreso y reintenta después de un breve retraso si es necesario.
- La descarga falla a mitad de transmisión: Reintenta la solicitud de archivo con retroceso y considera verificar tamaños de archivos parciales.
- Títulos o nombres de archivos inesperados: Sanea caracteres especiales y recurre al ID de video si falta el título.
Notas de seguridad y operativas
- Nunca incrustes tu clave API en código del lado del cliente. Proxy las solicitudes a través de tu backend o usa llamadas del lado del servidor.
- Registra IDs de solicitudes y marcas de tiempo con tus llamadas para simplificar la depuración y el soporte.
- Considera la política de contenido y los permisos de usuario para cualquier distribución posterior del audio descargado.
Próximos pasos
Una vez que verifiques tu primera solicitud, envuelve estas llamadas en la capa de servicio de tu aplicación, agrega reintentos mínimos y conecta eventos de progreso a tu UI. Usa los campos de título, duración y filesize para etiquetar y monitorear el procesamiento de audio.
Para probarlo ahora, abre la página del mercado y obtén una clave API: Iniciar prueba de 7 días en la API de Youtube a Audio. Obtendrás acceso basado en suscripción con una cuota. Consulta la página de la API para las opciones de acceso y precios actuales.
FAQ
¿Qué encabezado de autenticación se requiere?
Envía Authorization: Bearer YOUR_API_KEY en cada solicitud al endpoint de Zyla.
¿Qué endpoint devuelve metadatos como título y duración?
Usa GET https://zylalabs.com/api/381/youtube-to-audio-api/8884/get-audio con el parámetro id.
¿Cómo descargo el archivo de audio real?
Llama a uno de los endpoints de la API para obtener un enlace o downloadUrl, luego realiza un estándar HTTP GET en esa URL devuelta para recuperar el contenido binario.
¿Puedo comenzar con una URL completa de YouTube en lugar de un ID?
Sí. Usa GET https://zylalabs.com/api/381/youtube-to-audio-api/22174/download-audio con el parámetro url.
¿Hay un plan gratuito?
El acceso es por suscripción con cuota. La página del ítem ofrece una prueba de 7 días cuando está disponible. Consulta la página de la API para las opciones de acceso y precios actuales.