01
Apps de música y videojuegos
Deja que tus usuarios generen pistas originales, musicalicen prototipos y creen música para escenas interactivas sin salir de tu producto.
API para desarrolladores
API de generación de música con IA para desarrolladores
Genera pistas instrumentales originales o canciones con voz a partir de una descripción de estilo y de tus letras. Empieza con cURL o TypeScript, o conecta Cursor, Claude Code y Codex mediante MCP.
Disponible en los planes Pro y Ultra, con consumo por créditos.
Guía rápida con cURL
Terminal
curl https://www.lacuna.fm/api/v1/music/generations \
-H "Authorization: Bearer $LACUNA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"style": "lofi hip hop, mellow piano, 70 bpm",
"title": "Late Night Study",
"instrumental": true,
"model": "aether"
}'POST /api/v1/music/generationsCrear clave APIPensada para desarrolladores y agentes
Una API de generación de música que encaja en tu flujo de trabajo
De una petición a una pista alojada, ya sea con código directo, con un SDK o con el agente de programación que ya usas.
Pistas completas con una sola petición
- Describe el estilo y el título que necesitas
- Elige el modo instrumental o envía tus propias letras
- Recibe pistas completas con audio alojado y metadatos
Conecta Cursor, Claude Code y Codex
- Ejecuta el servidor oficial lacuna-mcp directamente desde npm
- Añade una clave API a la configuración MCP de tu agente de programación
- Pide música en lenguaje natural y recibe una pista alojada
Usa REST, TypeScript, CLI o MCP
- Llama a la API REST desde cualquier lenguaje de backend
- Usa los métodos tipados create, retrieve y waitFor en Node.js 18+
- Verifica firmas de webhook con el SDK oficial
Construye sobre un ciclo asíncrono claro
- Crea una tarea y consúltala con polling o llama a waitFor
- Recibe webhooks firmados job.completed y job.failed
- Recupera los créditos automáticamente cuando la generación falla
Elige tu integración
Empieza por la interfaz que encaja con tu stack
La misma Lacuna Music API está disponible mediante llamadas HTTP directas, un SDK tipado, herramientas de línea de comandos y un servidor MCP para Cursor, Claude Code, Codex y otros agentes de programación.
API REST
Llama a los endpoints HTTP desde cualquier lenguaje y revisa cada petición y respuesta en la referencia OpenAPI.
Ver referencia de la APISDK de TypeScript
Crea y consulta generaciones con métodos tipados, polling con waitFor, errores estructurados y verificación de webhooks.
Leer la guía rápidaLínea de comandos
Genera y controla pistas desde la terminal con la CLI de Lacuna Toolkit.
Ver configuración de la CLIMCP para agentes de IA
Da a los agentes de programación compatibles acceso a la generación de música a través del servidor MCP de Lacuna.
Usar con agentes de IACasos de uso
Dos grandes flujos de trabajo, una sola API de generación
Usa pistas completas dentro de productos interactivos o automatiza la producción musical detrás de tus flujos de contenido y de agentes.
02
Flujos de contenido y de agentes
Automatiza música original para vídeos, pódcasts, materiales de campaña, playlists y tareas que inicia tu agente de programación.
Preguntas frecuentes
Preguntas sobre la API de música con IA
Detalles actuales de acceso, generación, facturación e integración.
La API crea pistas instrumentales completas o canciones con voz. Cada petición incluye un título y una descripción de estilo; las generaciones con voz también necesitan las letras que envía tu aplicación.
No. En una generación con voz, las letras las aporta tu aplicación. Usa las herramientas de letras de Lacuna si necesitas crearlas antes de enviar la petición de música.
No. Al crear una generación se devuelve una tarea asíncrona. Puedes consultar su estado con polling, usar el helper waitFor del SDK de TypeScript o suscribirte a los webhooks firmados job.completed y job.failed.
Crea una clave API en tu perfil de Lacuna, guárdala en un gestor de secretos y envíala como token Bearer. Las claves se pueden rotar o revocar desde el mismo panel.
Sí. Instala el servidor oficial lacuna-mcp, añade tu clave API de Lacuna a la configuración MCP del agente y pide pistas en lenguaje natural. Las mismas herramientas funcionan en Cursor, Claude Code, Codex y otros clientes compatibles con MCP.
La Music API está disponible en los planes Pro y Ultra. El consumo es por créditos y los detalles actuales de cada plan están en la página de precios.
El endpoint de creación permite 60 peticiones por minuto y clave API. Los límites de generación simultánea son de 10 tareas en Pro y 20 en Ultra por defecto; puede haber valores específicos por cuenta.
Los créditos se descuentan al crear la tarea y se devuelven automáticamente si la generación falla. Los errores tipados y los eventos de webhook permiten que tu aplicación gestione el fallo de forma explícita.
Las canciones generadas mientras tienes una suscripción Pro o Ultra activa quedan cubiertas por la licencia comercial de Lacuna, y esos derechos comerciales se mantienen cuando termina la suscripción.
Construye con Lacuna
Haz tu primera petición a la API de música con IA
Crea una clave API, copia un comando cURL listo para ejecutar o conecta Cursor, Claude Code y Codex a través del servidor MCP de Lacuna.