Para desarrolladores
API de música y CLI
Convierte una idea o tus letras en una canción desde tus propios scripts. Usa la misma cuenta, créditos y biblioteca privada que en la app.
Conecta tu cuenta
- Crea una cuenta y verifica tu correo electrónico.
- Abre Configuración y crea una clave API. Claves API
- Guarda la clave en tu servidor o gestor de secretos. Envíala en la cabecera Authorization, nunca en una URL ni en código de frontend.
Las claves caducan a los 90 días. Puedes tener cinco claves activas y revocar cualquiera de inmediato en Configuración. Las claves de solo lectura no pueden generar canciones.
curl https://mcp.wordsintomusic.com/v1/account \
-H "Authorization: Bearer $WIM_API_KEY"Prepara, genera y consulta tu canción
Primero prepara las instrucciones sin gastar créditos. Iniciar esa preparación utiliza un crédito de canción existente. Conserva el mismo ID de solicitud al reintentar. Un tiempo de espera no debe iniciar otra canción.
{
"requestId": "my-first-song-20261021",
"input": {
"mode": "idea",
"idea": "Una canción esperanzadora sobre empezar de nuevo en una ciudad",
"direction": "Pop acústico cálido, batería constante, voz suave",
"language": "es",
"duration": 120
},
"uiLocale": "es"
}Envía este JSON a POST /v1/songs/prepare. Después envía su preparedRequestId a POST /v1/songs/start. Consulta GET /v1/jobs/{jobId} con intervalos de al menos 15 segundos. Cuando esté lista, abre el enlace privado de tu biblioteca para escucharla o descargarla.
Los idiomas de las canciones son inglés, español, alemán, francés y portugués de Brasil. Solicita entre 60 y 180 segundos. Usa el modo lyrics para tus propias letras o instrumental: true para música sin voces.
Endpoints de la API
| Método y ruta | Acción |
|---|---|
GET /v1/account | Consulta tus créditos de canciones |
POST /v1/songs/prepare | Prepara una canción sin gastar créditos |
POST /v1/songs/start | Genera la canción preparada con un crédito existente |
GET /v1/jobs/{jobId} | Consulta el estado de generación |
GET /v1/songs | Consulta tu biblioteca privada de canciones |
GET /v1/songs/{id} | Consulta una de tus canciones |
La URL base de la API es https://mcp.wordsintomusic.com/v1. Descarga la especificación OpenAPI para consultar los campos, límites, permisos y formatos de respuesta.
Usa la línea de comandos
npm install -g words-into-music-cli
wim login --key-stdin
wim account
wim prepare --file brief.json
wim start PREPARED_REQUEST_ID --confirm
wim job JOB_ID
wim songs --limit 10Usa Node.js 22 o posterior. Pasa la clave a login por la entrada estándar o proporciona WIM_API_KEY desde tu gestor de secretos. No la incluyas en argumentos ni en el historial de comandos. Ejecuta wim --help para más detalles.
Créditos, límites y privacidad
El acceso a la API y la CLI no requieren una suscripción adicional. Generar una grabación utiliza tus créditos existentes, con los mismos límites que la app. La API nunca compra créditos ni inicia suscripciones.
Solo se pueden consultar las canciones del propietario de la clave. Las letras se devuelven únicamente si se solicitan. Revocar una clave bloquea nuevas llamadas; una canción ya aceptada sigue procesándose.
La pasarela permite hasta 30 solicitudes API por minuto por IP. Las llamadas API y MCP comparten un límite de 120 solicitudes por cuenta y minuto. Respeta Retry-After en las respuestas 429. Los ID de preparaciones completadas se conservan para evitar duplicados durante 30 días tras caducar.
Para conectar asistentes, consulta nuestra Guía de configuración MCP. Para consultar las cuotas de tu cuenta, visita Precios.
