Generación de Música con Eleven Music REST API (TypeScript)

En esta lección, aprenderás a interactuar con la API REST de Eleven Music para generar música a partir de un prompt de texto. Aunque ElevenLabs ofrece SDKs, nos enfocaremos en la comunicación directa con la API para entender mejor los fundamentos de las solicitudes HTTP y las respuestas. Esta habilidad es crucial para integrar modelos de IA en tus aplicaciones de manera flexible y eficiente.

Antes de escribir cualquier código, invoca la habilidad /music para aprender los patrones correctos del SDK de ElevenLabs. Esto te dará una base sólida, incluso si en este ejercicio usamos la API REST directamente.

index.ts

Crea un script amigable para tutoriales que genere música a partir de un prompt de texto utilizando la API REST de Eleven Music en vivo. No uses el SDK de ElevenLabs JS para music v2 todavía.

Este script será una herramienta práctica para experimentar con la generación de música. Nos centraremos en la simplicidad y la claridad para que puedas entender cada paso del proceso.

• Carga las variables de entorno desde .env.

  Es fundamental cargar las variables de entorno, como tu clave de API, de un archivo .env para mantener tus credenciales seguras y fuera del código fuente. Esto es una buena práctica de seguridad y facilita la gestión de diferentes entornos (desarrollo, producción).

• Lee el prompt de música de los argumentos de la CLI; si no se proporciona, usa A chill lo-fi beat with jazzy piano chords.

  Permitir que el usuario especifique el prompt a través de la línea de comandos hace que tu script sea más flexible. Si no se proporciona un prompt, usaremos un valor predeterminado para que el script siempre pueda ejecutarse.

• Construye un cuerpo de solicitud con prompt, music_length_ms: 10_000 y model_id: "music_v2".

  El cuerpo de la solicitud JSON contendrá los parámetros necesarios para que la API de Eleven Music genere la música. Esto incluye el prompt de texto y cualquier otra configuración relevante para la generación de audio.

• Usa fetch para POSTear el cuerpo JSON a https://api.elevenlabs.io/v1/music.

  Aquí es donde realizamos la llamada a la API. Utilizaremos una biblioteca HTTP para enviar una solicitud POST con el cuerpo JSON que hemos construido a la URL del endpoint de Eleven Music.

• Guarda el cuerpo de la respuesta MP3 devuelto en output.mp3.

  La API responderá con un archivo MP3 que contiene la música generada. Guardaremos este contenido binario directamente en un archivo local para que puedas reproducirlo.

• Imprime un mensaje de éxito con la ruta de salida.

  Una vez que la música se haya guardado, informaremos al usuario sobre la ubicación del archivo para que sepa dónde encontrar su creación.

• Mantén el código en el camino feliz; una simple verificación response.ok es suficiente.

  Para este tutorial, nos centraremos en el escenario ideal donde la solicitud es exitosa. Una verificación básica del estado de la respuesta HTTP será suficiente para confirmar que la operación fue exitosa.

Resumen

• Aprendiste a interactuar directamente con la API REST de Eleven Music para generar audio.
• Practicaste la carga segura de variables de entorno para proteger tus credenciales.
• Construiste un cuerpo de solicitud JSON para enviar parámetros a una API.
• Realizaste una solicitud POST HTTP y manejaste la respuesta binaria (MP3).
• Guardaste el archivo de audio generado localmente y confirmaste el éxito de la operación.