Cómo generar canciones con IA mediante la ACE Music API
22 min de lectura • 14 de noviembre de 2026
Índice
- Introducción
- Modelos y lo que puede hacer la API
- Precios
- Cómo generar una canción con curl
- Canta tu propia letra
- Controla el tempo, la tonalidad y el compás con ACE-Step
- Covers, remixes y ediciones
- Guía tus canciones con tu propio audio e imágenes
- Stems, descargas y la partitura
- Tu Biblioteca
- Varias cuentas de ACE Music
- Úsala desde Claude, ChatGPT o Cursor (MCP)
- Genera por lotes con los scripts
- Ejemplos
- Preguntas
- Conclusión
Introducción
La ACE Music API de useapi.net convierte una sola llamada REST en dos canciones terminadas de ACE Music, con voces, letra, título y portada, con la suscripción de ACE Music que ya tienes. ACE Music v1 ocupa el primer puesto del ranking de música vocal de Artificial Analysis, por delante de Suno v6, y ACE Music v1 y v1.1 no tienen una API pública propia (a noviembre de 2026), así que useapi.net es la única forma de usarlos desde código. El modelo de código abierto ACE-Step v1.5 XL funciona con la misma API sin gastar créditos en ningún plan de ACE Music, incluido el plan Free.
Esta guía empieza por los tres modelos y lo que cuesta una canción, crea una canción de principio a fin con curl y luego resume todas las demás funciones en una tabla breve. Los Ejemplos del final son 18 canciones que hicimos para esta página, cada una con la solicitud que la generó, todas con los scripts del repositorio de GitHub acemusic-api (Node.js y Python), por 117 créditos de un plan Artist, tomas extra incluidas. useapi.net es una API de terceros, sin afiliación con ACE Music ni con su creador, Timedomain.
Modelos y lo que puede hacer la API
Cada solicitud genera dos canciones, y model elige quién las hace:
| Modelo | model | Para qué sirve | Ajustes | Créditos por solicitud | Tiempo en nuestras pruebas |
|---|---|---|---|---|---|
| ACE Music v1 | acemusic-v1 (por defecto) | El modelo vocal número 1: canciones a partir de un prompt o de tu letra, cantadas o instrumentales | duration de 30 a 600 s, negative, styleInfluence, descargas en WAV | 4 | De 46 a 89 s |
| ACE Music v1.1 Preview | acemusic-v1.1 | Escribe primero una partitura, así que sus covers y mashups siguen la melodía de una canción | audioInfluence, styleInfluence | 4 | De 35 a 83 s |
| ACE-Step v1.5 XL | ace-step-1.5-xl | Código abierto de ACE Studio y StepFun: canciones, remixes y ediciones | bpm, key, timeSignature, duration de 10 a 240 s, negative, thinking. Solo MP3 | 0 | De 20 a 55 s |
Lo que puedes hacer con ellos:
| Qué | Solicitud | Notas |
|---|---|---|
| Canciones a partir de un prompt | POST /music prompt | ACE Music escribe el estilo, la letra y el título |
| Tu propia letra, instrumentales | POST /music style, lyrics | En cualquier idioma |
| Generadores de letra y de estilo | POST /music/lyrics, /music/style | Sin créditos |
| Covers, remixes, ediciones, mashups | POST /music mode | Con cualquier canción de la cuenta |
| Tu audio y tus imágenes | POST /files | Como referencias para canciones nuevas |
| Stems | POST /music/stems | Creator y Artist |
| Descargas, partitura | GET /music/download, /music/score | MP3 y la partitura en todos los planes, WAV, MIDI y MusicXML en Creator y Artist |
| Biblioteca, jobs, cuentas | GET /music, /jobs, /accounts | Todas las canciones de la cuenta, los jobs en curso, los créditos en vivo |
| Servidor MCP | /v1/acemusic/mcp | 15 herramientas para asistentes de IA |
Precios
ACE Music cobra sus propios créditos por solicitud, de tu plan de ACE Music, y useapi.net no agrega nada por canción (a noviembre de 2026):
| Solicitud | Créditos |
|---|---|
| Dos canciones con ACE Music v1 o v1.1 | 4 |
| Stems, voz + instrumental | 5, planes de pago |
| Stems, todos los stems | 60, planes de pago |
| Partitura de una canción de ACE-Step, primera lectura | 1 |
| Dos canciones con ACE-Step v1.5 XL | 0, en todos los planes |
| Generadores de letra y de estilo, subidas, descargas | 0 en nuestras pruebas |
Los planes de ACE Music son Free, con 20 créditos al día, Creator, a US$9,90 al mes por 1.000 créditos, y Artist, a US$29 al mes por 2.500 créditos, o US$7,90 y US$16,58 al mes con pago anual. Una canción es media solicitud: 2 créditos. La descripción general de la API tiene la misma tabla.
Lo que cuesta una canción en cada plan, con el más barato a la izquierda (una solicitud genera dos canciones, así que una canción cuesta la mitad de los créditos de una solicitud. Precios en dólares estadounidenses, a noviembre de 2026):
| Modelo | Free 20 cr/día | Artist $16,58/mes 2.500 cr/mes, pago anual | Creator $7,90/mes 1.000 cr/mes, pago anual | Creator $9,90/mes 1.000 cr/mes | Artist $29/mes 2.500 cr/mes |
|---|---|---|---|---|---|
| ACE Music v1, v1.1 una canción | $0 / 2 cr 10 al día | $0,013 / 2 cr 1.250 al mes | $0,016 / 2 cr 500 al mes | $0,020 / 2 cr 500 al mes | $0,023 / 2 cr 1.250 al mes |
| Stems voz + instrumental | planes de pago | $0,033 / 5 cr | $0,040 / 5 cr | $0,050 / 5 cr | $0,058 / 5 cr |
| Stems todos los stems | planes de pago | $0,40 / 60 cr | $0,47 / 60 cr | $0,59 / 60 cr | $0,70 / 60 cr |
| Partitura de ACE-Step primera lectura | $0 / 1 cr | $0,007 / 1 cr | $0,008 / 1 cr | $0,010 / 1 cr | $0,012 / 1 cr |
| ACE-Step v1.5 XL una canción | $0 / 0 cr | $0 / 0 cr | $0 / 0 cr | $0 / 0 cr | $0 / 0 cr |
Cómo se compara con las otras formas de usar estos modelos desde código (en dólares estadounidenses):
| Modelo | useapi.net | Otras API |
|---|---|---|
| ACE Music v1, v1.1 Preview | Desde $0,013 por canción en Artist con pago anual, $0 con los 20 créditos diarios del plan Free | Ninguna: ACE Music no ofrece una API pública para ellos |
| ACE-Step v1.5 XL | $0 en todos los planes de ACE Music, incluido el plan Free | Unos $0,14 por canción en la API de terceros de acestep.io, que requiere su plan Studio de $49 al mes |
En cualquier plan de ACE Music, incluido el plan Free, una canción de ACE-Step v1.5 XL no gasta créditos, frente a la API de acestep.io, un sitio de terceros que requiere su plan Studio de US$49 al mes (unas 360 canciones al mes, unos US$0,14 por canción, a noviembre de 2026).
Empieza a usar la API
Una sola suscripción de US$15 al mes cubre todas las API de useapi.net: un token para todos los servicios. Conectas hasta 3 cuentas propias por servicio, cada una con la suscripción de su sitio web, y useapi.net se encarga de la API REST, el balanceo de carga y el polling. ¿Necesitas más cuentas? Cada suscripción adicional cuesta US$10 al mes y suma 3 cuentas más por servicio.
Suscríbete — US$15/mes Pagar con cripto
¿No tienes una tarjeta de crédito internacional? También puedes suscribirte con criptomonedas (los pagos con cripto no se reembolsan). Los precios y los planes por volumen están en la página de suscripción. Si pagas con Stripe, recibes el reembolso completo dentro de los 14 días posteriores a la primera compra, si tienes menos de 50 generaciones exitosas. ¿Ya tienes una suscripción? Cambia la cantidad en el portal de clientes de Stripe en lugar de volver a comprar.
Cómo generar una canción con curl
Necesitas un token de la API de useapi.net, consulta Setup useapi.net, y una cuenta de ACE Music con correo y contraseña. Una sola suscripción de US$15 al mes cubre todas las API de useapi.net y 3 cuentas de ACE Music. Una cuenta Free de ACE Music funciona: recibe 20 créditos al día, y las canciones de ACE-Step no necesitan ninguno. Los comandos usan jq para leer el JSON.
Agrega tu cuenta de ACE Music
Exporta el token y agrega la cuenta una sola vez. La API inicia sesión, lee la cuenta y la guarda solo si ACE Music acepta la contraseña:
export USEAPI_TOKEN="user:12345-..."
API=https://api.useapi.net/v1/acemusic
curl -s -X POST "$API/accounts" \
-H "Authorization: Bearer $USEAPI_TOKEN" \
-H "Content-Type: application/json" \
-d '{ "email": "[email protected]", "password": "your-acemusic-password" }'
Una cuenta creada con Continuar con Google o con un número de teléfono necesita primero una contraseña, consulta Setup ACE Music, que también puede agregarla por ti.
Crea canciones a partir de un prompt
Describe la canción con tus propias palabras. ACE Music escribe el estilo, la letra y el título, y luego genera dos canciones. Esta es la solicitud exacta detrás de la primera canción de esta página:
curl -s -X POST "$API/music" \
-H "Authorization: Bearer $USEAPI_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"prompt": "A late-night neo-soul slow jam about two strangers sharing an umbrella at a bus stop in the rain and missing the last bus on purpose. Warm Rhodes piano, brushed drums, round upright bass, a smoky female lead with close three-part harmonies on the chorus.",
"model": "acemusic-v1",
"async": true
}' | tee job.json | jq '{jobid, status, model}'
Con async: true, la API responde 201 de inmediato con el job. Un prompt puede tener hasta 2.000 caracteres y llevar hasta 3 canciones de referencia y 3 imágenes, consulta Guía tus canciones con tu propio audio e imágenes.
Lo que recibes
Mientras ACE Music escribe la letra, las canciones están en planning y Untitled, luego en queued y running. Consulta GET /jobs/jobid más o menos cada 10 segundos. El jobid contiene : y @, así que codifícalo para la URL:
curl -s "$API/jobs/$(jq -r .jobid job.json | jq -Rr @uri)" \
-H "Authorization: Bearer $USEAPI_TOKEN" | jq '{status, songs: [.songs[] | {title, status, duration, audioUrl}]}'
Cuando status es completed, cada canción trae sus enlaces (los ids de abajo son inventados):
{
"jobid": "j1115003713275918262m-u12345-email:[email protected]:so_7c1d9e3a5b2f4806a4e1c9d3.so_8b4f2e6a1c9d47e5a3b7c0d2-bot:acemusic",
"type": "music",
"status": "completed",
"email": "[email protected]",
"created": "2026-11-15T00:37:13.275Z",
"model": "acemusic-v1",
"modelUsed": "acemusic-v1",
"songs": [
{
"songId": "user:[email protected]:so_7c1d9e3a5b2f4806a4e1c9d3",
"taskId": "so_7c1d9e3a5b2f4806a4e1c9d3",
"status": "succeeded",
"title": "Let the 44 Roll By",
"model": "acemusic-v1",
"style": "Late-night neo-soul slow jam with a laid-back 1990s and early 2000s pocket, 72 BPM. …",
"lyrics": "[Intro - Warm Rhodes chords, brushed snare rim clicks, subtle rain on asphalt]\n\n[Verse 1 …]\nWater dripping off the canvas seam\n…",
"instrumental": false,
"duration": 277.19,
"audioUrl": "https://acemusic.ai/data/so_7c1d9e3a5b2f4806a4e1c9d3.mp3",
"playUrl": "https://….r2.cloudflarestorage.com/acemusic-data-prod/users/…/audio/202611/….mp3?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20261115T003902Z&X-Amz-Expires=3599&…",
"playUrlExpires": "2026-11-15T01:39:01.000Z",
"coverUrl": "https://acemusic.ai/data/so_7c1d9e3a5b2f4806a4e1c9d3-cover.jpg?v=1794703081642",
"pageUrl": "https://acemusic.ai/song/r4k8w2n6p9tz",
"created": "2026-11-15T00:37:13.300Z",
"finished": "2026-11-15T00:38:42.208Z",
"kind": "original",
"score": false
},
{ "songId": "user:[email protected]:so_8b4f2e6a1c9d47e5a3b7c0d2", "title": "Let the 44 Roll By", "duration": 253.99, "…": "…" }
],
"completed": "2026-11-15T00:38:42.208Z"
}
audioUrles el enlace público al MP3 de la canción y nunca cambia.playUrles un enlace directo al mismo MP3 para reproductores web, válido hastaplayUrlExpires(alrededor de una hora): algunos navegadores, como Brave, bloquean la redirección detrás deaudioUrl.songIdes lo que reciben los covers, los mashups, los stems, las descargas y la partitura. Indica la cuenta en la que está la canción, así que esas llamadas se ejecutan ahí.modeles el modelo que pediste, ymodelUsed, el que se ejecutó (consulta los mashups).kindesoriginal,cover,edit,mashupoupload, yscoreindica si la canción ya tiene su partitura.- Una canción que ACE Music no pudo generar tiene
status: "failed", el motivo de ACE Music enerroryrefunded: truecuando se devolvieron los créditos.
Y esta es la primera de esas dos canciones:
ACE Music v1 — “Let the 44 Roll By” · 4:37 · generada en 89 s
Sync, async y webhooks
| Lo que envías | El POST responde | Después |
|---|---|---|
async: true | 201 de inmediato, con el job | Consulta GET /jobs/jobid |
Sin async | 200 con el job terminado, el mismo JSON de arriba | Lee las canciones de la respuesta. Una solicitud que sigue en curso después de 100 segundos responde 202 con el job: consúltalo |
replyUrl y replyRef | Como arriba, tanto en sync como en async | Tu URL pública https recibe un solo POST con el job terminado, con tu replyRef incluido |
Nuestra solicitud de ACE-Step sin async volvió en 37 segundos, y el webhook llegó 12 segundos después de que terminaran las canciones. Un job se puede leer durante 7 días, y uno que sigue en curso 30 minutos después de empezar falla con 504. async-webhooks/ prueba las tres formas e incluye un pequeño receptor de webhooks.
Mostrar la llamada a la API
curl -s -X POST "$API/music" \
-H "Authorization: Bearer $USEAPI_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"prompt": "A dreamy lo-fi hip hop beat for studying late at night: dusty vinyl crackle, mellow Rhodes chords, a soft upright bass and rain on the window",
"model": "ace-step-1.5-xl",
"replyUrl": "https://your-server.example.com/acemusic-hook",
"replyRef": "lofi-1"
}' | jq '{status, songs: [.songs[] | {title, duration, audioUrl}]}'
Canta tu propia letra
Envía style y lyrics en lugar de prompt, y ACE Music canta tus palabras con tu estilo:
| Campo | Qué hace | Límites |
|---|---|---|
style | Género, instrumentos, ambiente, tempo y voces | 1.000 caracteres, 512 en ACE-Step |
lyrics | Tu letra, en cualquier idioma, con las etiquetas [Verse], [Chorus] y [Bridge] | 5.000 caracteres, 2.000 en ACE-Step |
title | El título de las canciones. Si no lo envías, ACE Music lo elige | 80 caracteres |
instrumental | true para que no haya voces. Un style sin lyrics hace lo mismo | |
duration | La duración en segundos | De 30 a 600 en ACE Music v1, de 10 a 240 en ACE-Step |
negative | Estilos que hay que evitar | 200 caracteres, ACE Music v1 y ACE-Step |
styleInfluence | Qué tan fielmente se sigue el estilo | De 0 a 100, por defecto 80, ACE Music v1 y v1.1 |
Nunca envíes prompt junto con estos campos: la API responde 400 e indica qué quitar. Nuestra balada, pedida con duration: 210, volvió con 210 y 209 segundos. Está en Ejemplos, junto con un instrumental y una canción en español.
¿Todavía no tienes letra? POST /music/lyrics escribe la letra y un título a partir de una solicitud, y POST /music/style convierte unas pocas palabras en un estilo completo. Los nuestros volvieron en 6 y 4 segundos, sin cobrar créditos. Script: custom-lyrics/.
Controla el tempo, la tonalidad y el compás con ACE-Step
ACE-Step v1.5 XL acepta ajustes musicales que los modelos de ACE Music no aceptan, y sus canciones no gastan créditos:
| Opción | Valores |
|---|---|
bpm | De 30 a 200 |
timeSignature | 2/4, 3/4, 4/4, 6/8 |
key | De C major a B minor (C, C#, D, Eb, E, F, F#, G, Ab, A, Bb, B) |
duration | De 10 a 240 segundos |
negative | Estilos que hay que evitar, hasta 200 caracteres |
thinking | De 0 a 100: ACE-Step planifica primero toda la canción, creativo con valores bajos, estable con valores altos |
Nuestras tres canciones de ACE-Step, un vals en 3/4, una giga en 6/8 y un drum and bass a 174 bpm, volvieron exactamente con la duración pedida (Ejemplos). Estas opciones solo funcionan con mode generate en ace-step-1.5-xl, y en cualquier otro caso la API responde 400 Parameter bpm does not apply to mode generate on acemusic-v1. Script: ace-step-options/.
Covers, remixes y ediciones
mode convierte una solicitud en trabajo sobre canciones que ya tienes. references recibe sus songId: canciones que generó la API, canciones de tu Biblioteca o tus propias subidas.
mode | references | Se ejecuta en | Créditos | Qué hace |
|---|---|---|---|---|
cover | 1 canción | acemusic-v1.1, o ACE-Step en ace-step-1.5-xl | 4 / 0 | La canción con un style nuevo, siguiendo su melodía, sus acordes y su estructura |
remix | 1 canción | ace-step-1.5-xl | 0 | coverStrength conserva el original, remixStrength se aleja de él (de 0 a 100) |
edit | 1 canción | ace-step-1.5-xl | 0 | Reescribe la parte entre los segundos start y end con la letra nueva de lyrics y conserva el resto |
mashup | 2 o 3 canciones | acemusic-v1.1 | 4 | Una canción nueva a partir de varias, consulta abajo |
ACE Music v1.1 sigue la melodía que lee en la partitura de una canción. Nuestro primer cover de una canción de ACE Music v1 que aún no tenía partitura falló con ref_no_melody, y se devolvieron los 4 créditos, así que ahora la API lee primero, gratis, la partitura de una canción de ACE Music v1 antes de un cover o un mashup con v1.1. Las canciones de ACE-Step no se leen automáticamente: si una responde 400 con ref_no_melody, llama primero a GET /music/score con ella (1 crédito) y luego vuelve a enviar la solicitud. Script: covers-remix-edit/.
Haz un mashup de dos o tres canciones
mode: "mashup" crea una sola canción a partir de 2 o 3 canciones de la misma cuenta y combina sus letras, salvo que envíes lyrics. audioInfluence (de 0 a 100, por defecto 60) define qué tan de cerca se siguen las canciones. Un mashup tiene que leer las canciones, así que se ejecuta en ACE Music v1.1 Preview aunque pidas v1, igual que en el sitio web de ACE Music: nuestro “Harbor Fiesta” muestra "model": "acemusic-v1" y "modelUsed": "acemusic-v1.1", y los créditos son los del modelo que se ejecutó. Lo mismo pasa con un cover pedido en v1, con un prompt con más de una referencia en ACE-Step y, a veces, con un prompt con una canción de referencia. Script: mashup/.
Guía tus canciones con tu propio audio e imágenes
POST /files recibe el archivo como cuerpo sin procesar de la solicitud, con su Content-Type:
| Subida | Formatos | Hasta | Recibes | Úsalo como |
|---|---|---|---|---|
| Audio | MP3, WAV, FLAC, OGG, M4A, AAC | 100 MB, 8 minutos | Un songId: una canción de la Biblioteca, con su letra, estilo, tempo y melodía transcritos por ACE Music | Una de hasta 3 references de un prompt, o la canción para hacer un cover, un remix, una edición o un mashup |
| Imagen | JPEG, PNG, WebP | 10 MB | Un mediaId | Una de hasta 3 images de un prompt: ACE Music escribe una canción sobre ella |
curl -s -X POST "$API/files?title=Harbour%20Jig%20demo" \
-H "Authorization: Bearer $USEAPI_TOKEN" \
-H "Content-Type: audio/mpeg" \
--data-binary @harbour-jig-demo.mp3 | jq '{songId, status, duration, bpm: .upload.bpm}'
Nuestra subida de 90 segundos del “Harbour Jig” se transcribió en 14 segundos, y ACE Music detectó 115 bpm (habíamos pedido 116). La foto de un robot bailando se convirtió en una canción de drum and bass sobre su pelaje verde azulado y sus tenis altos naranjas. Las dos están en Ejemplos. Las subidas cuentan contra el límite de la cuenta: 10 minutos de audio en Free, 30 en Creator y 60 en Artist. Script: upload-reference/.
Stems, descargas y la partitura
Toda canción terminada se puede separar, descargar y leer como partitura:
| Solicitud | Planes | Créditos | Recibes |
|---|---|---|---|
Stems, mode: "vocals" | Creator, Artist | 5 | Los MP3 vocal e instrumental |
Stems, mode: "all" | Creator, Artist | 60 | Cada stem que encuentra ACE Music, en MP3 |
Descarga mp3 (por defecto) | Todos los planes | 0 | url (igual que audioUrl) y playUrl |
Descarga wav | Creator, Artist | 0 | Un enlace válido por 24 horas. No para canciones de ACE-Step |
Descarga midi, musicxml | Creator, Artist | 0 | El archivo en sí |
| Partitura | Todos los planes | 0, 1 para una canción de ACE-Step la primera vez | Notación ABC: la melodía vocal, una línea instrumental, los acordes y las secciones |
Separa una canción en stems
La separación de voz de “Paper Lanterns” tardó unos 80 segundos, y la completa, menos de 2 minutos, con 9 stems: voces, coros, batería, bajo, guitarra, teclado, cuerdas, sintetizador y efectos (escúchalos). Los enlaces de los stems duran 24 horas, así que vuelve a leer la canción para obtener enlaces nuevos. Volver a separar una canción en el mismo modo responde de inmediato y no cobra nada.
Descarga MP3, WAV, MIDI y MusicXML
ACE Music genera el WAV, el MIDI y el MusicXML con la primera solicitud: la API espera hasta un minuto y luego responde 202, así que vuelve a llamar un minuto después. Para “Paper Lanterns” los tres estuvieron listos en segundos: un WAV de 40 MB, un archivo MIDI de 8 KB y una partitura MusicXML de 107 KB.
Mostrar la llamada a la API
SONG="user:[email protected]:so_4e7b2c9d0a5f4183b6d8e2c7"
curl -s -G "$API/music/download" --data-urlencode "songId=$SONG" -d format=wav \
-H "Authorization: Bearer $USEAPI_TOKEN" | jq '{url, expires}'
curl -s -G "$API/music/download" --data-urlencode "songId=$SONG" -d format=midi \
-H "Authorization: Bearer $USEAPI_TOKEN" -o paper-lanterns.mid
Lee la partitura
Cualquier herramienta de ABC convierte la partitura en notación musical. Para “Paper Lanterns” indicó 72 bpm, el tempo que pedimos en el estilo. Las canciones de ACE Music v1.1 vienen con su partitura, y los covers y mashups de v1.1 la siguen, consulta Covers, remixes y ediciones.
Mostrar la llamada a la API
SONG="user:[email protected]:so_4e7b2c9d0a5f4183b6d8e2c7"
curl -s -G "$API/music/score" --data-urlencode "songId=$SONG" \
-H "Authorization: Bearer $USEAPI_TOKEN" | jq -r .abc | head -14
X:1
T:
M:2/4
L:1/16
Q:1/4=72
V: Vocal clef=treble name="Vocal Melody" snm="Vocal"
V: Ins clef=treble name="Ins Melody" snm="Inst."
K:Ab
% intro
V: Vocal
Z|"Ab"z8|"Ab"z8|"Ab"z8|
V: Ins
Z|Ac2AcBA2|A2EAA2EA|Ac2AcBA2|
Script: stems-and-downloads/, que guarda los stems, cada formato de descarga y la partitura.
Tu Biblioteca
Cada canción y cada subida de la cuenta, hecha aquí o en acemusic.ai, se queda en su Biblioteca hasta que la borres:
| Solicitud | Qué hace |
|---|---|
| GET /music | Una página de canciones, de la más reciente a la más antigua, con next para la página siguiente. email es obligatorio si tienes más de una cuenta. Las canciones de los jobs de más de 7 días están aquí |
GET /music/songId | Una canción con enlaces nuevos, y sus stems si se separó |
DELETE /music/songId | 204: la canción pasa a la papelera de la cuenta en acemusic.ai, y desde entonces la API responde 404 para ella |
Mostrar la llamada a la API
SONG="user:[email protected]:so_4e7b2c9d0a5f4183b6d8e2c7"
curl -s -G "$API/music" --data-urlencode "[email protected]" -d limit=20 \
-H "Authorization: Bearer $USEAPI_TOKEN" | jq '{next, songs: [.songs[] | {title, model, kind, songId}]}'
curl -s "$API/music/$(jq -rn --arg v "$SONG" '$v|@uri')" \
-H "Authorization: Bearer $USEAPI_TOKEN" | jq '{title, score, audioUrl, playUrl, stems: (.stems // {} | keys)}'
curl -s -o /dev/null -w "%{http_code}\n" -X DELETE "$API/music/$(jq -rn --arg v "$SONG" '$v|@uri')" \
-H "Authorization: Bearer $USEAPI_TOKEN"
Script: library/.
Varias cuentas de ACE Music
Cada suscripción de useapi.net conecta 3 cuentas de ACE Music, hasta 100 en total. Una solicitud sin email va a una cuenta en buen estado con un espacio libre, y una que indica una canción, una subida o una imagen se ejecuta en la cuenta donde está. Una cuenta ejecuta hasta maxJobs solicitudes a la vez, 4 por defecto, el propio límite de ACE Music. Con todas las cuentas ocupadas, la API responde 429 con Retry-After, y si ACE Music rechaza una contraseña, esa cuenta responde 596 hasta que la vuelvas a agregar.
GET /accounts/email lee en vivo el plan, los créditos y lo que cuesta cada cosa en créditos, y POST /accounts solo con email y maxJobs cambia únicamente maxJobs. Script: accounts/.
Mostrar la llamada a la API
curl -s "$API/accounts/$(jq -rn --arg v "[email protected]" '$v|@uri')" \
-H "Authorization: Bearer $USEAPI_TOKEN" | jq '{plan_name, credits, maxJobs, costs}'
curl -s -X POST "$API/accounts" \
-H "Authorization: Bearer $USEAPI_TOKEN" \
-H "Content-Type: application/json" \
-d '{ "email": "[email protected]", "maxJobs": 2 }'
Úsala desde Claude, ChatGPT o Cursor (MCP)
Las mismas funciones están disponibles como un servidor MCP alojado con 15 herramientas, desde canciones, covers y mashups hasta stems, partituras y subidas. ACE Music no ofrece una integración MCP pública propia (a noviembre de 2026). En Claude Code basta con un comando:
claude mcp add --transport http useapi-acemusic https://api.useapi.net/v1/acemusic/mcp --header "Authorization: Bearer YOUR_API_TOKEN"
Cursor, VS Code y Windsurf usan la misma URL y el mismo encabezado, y la app de Claude y ChatGPT inician sesión con OAuth, consulta Use it in the Claude app or ChatGPT. Después pide lo que quieras con tus palabras: “Write lyrics about a cat who loves rainy days and sing them as acoustic indie folk on ACE Music v1”.
Genera por lotes con los scripts
El repositorio de GitHub acemusic-api tiene un ejemplo por función, enlazado desde cada sección anterior: un script de Node.js y su gemelo en Python, sin nada que instalar. Cada uno lee sus solicitudes de un prompts.json que tú editas, ejecuta hasta 4 a la vez, consulta los jobs y guarda en su carpeta output/ las dos canciones, sus portadas, el registro del job y un ledger.jsonl con los créditos gastados.
Necesitas Node.js 21 o posterior o Python 3.8 o posterior. --only 3 ejecuta el tercer prompt de abajo, una canción de ACE-Step sin créditos, así que funciona con una cuenta Free:
git clone https://github.com/useapi/acemusic-api.git && cd acemusic-api
export USEAPI_TOKEN="user:12345-..."
node songs-from-prompt/songs-from-prompt.mjs --only 3
Cada registro de job guardado contiene los songId de las canciones, y --from <job>.json --pick 1 pasa la canción 1 al siguiente script para hacer un cover, un mashup o separarla en stems.
Abrir songs-from-prompt/prompts.json
[
{
"_about": "ACE Music v1 (the default model, 4 credits for two songs): ACE Music writes the style, lyrics and title from your idea",
"prompt": "A late-night neo-soul slow jam about two strangers sharing an umbrella at a bus stop in the rain and missing the last bus on purpose. Warm Rhodes piano, brushed drums, round upright bass, a smoky female lead with close three-part harmonies on the chorus.",
"model": "acemusic-v1"
},
{
"_about": "ACE Music v1.1 Preview (4 credits): writes a score first, then the audio",
"prompt": "An anthemic Celtic folk-rock singalong about a fishing crew racing a storm back to the harbor. Fiddle and tin whistle hooks, stomping kick drum, bodhran, a gravelly male lead and the whole crew shouting the chorus.",
"model": "acemusic-v1.1"
},
{
"_about": "ACE-Step v1.5 XL (no credits on any ACE Music plan, the Free plan included)",
"prompt": "A breezy bossa nova for a lazy Sunday afternoon in Lisbon: nylon-string guitar, soft brushed snare, upright bass, a gentle flute line and a warm male and female duet sung in Portuguese.",
"model": "ace-step-1.5-xl"
}
]
Ejemplos
Todas las canciones de abajo se hicieron el 14 de noviembre de 2026 (PST) con los scripts del repositorio en una cuenta Artist de ACE Music, y cada una es la primera de las dos canciones de su solicitud. Los títulos son de ACE Music, salvo cuando pusimos uno, los tiempos van desde la solicitud hasta que terminan las dos canciones, y las llamadas muestran ids inventados.
Una canción a partir de una imagen
Entra una imagen y una frase de estilo, salen dos canciones terminadas. Subimos esta foto de una mascota robot bailando y pedimos drum and bass. ACE Music escribió la letra a partir de lo que vio: “Teal fur shaking on the concrete floor, orange high-tops squeaking by the studio door”.

Bouncy, playful drum and bass for a dancing robot mascot: rolling breakbeats at
174 bpm, a wobbly reese bass, bleepy robot synth hooks, vocoder chops, cheeky and
upbeat.
ACE Music v1 — “Bleep Boop Bounce” · 2:47 · generada en 72 s
Mostrar la llamada a la API
curl -X POST 'https://api.useapi.net/v1/acemusic/files' \
-H 'Authorization: Bearer user:12345-…' \
-H 'Content-Type: image/png' \
--data-binary @robot-mascot.png
curl -X POST 'https://api.useapi.net/v1/acemusic/music' \
-H 'Authorization: Bearer user:12345-…' \
-H 'Content-Type: application/json' \
-d '{
"prompt": "Bouncy, playful drum and bass for a dancing robot mascot: rolling breakbeats at 174 bpm, a wobbly reese bass, bleepy robot synth hooks, vocoder chops, cheeky and upbeat.",
"model": "acemusic-v1",
"images": ["user:[email protected]:cx_3b9e1d7a5c2f48e0a6d4b8c1"],
"async": true
}'
Canciones a partir de un prompt
La canción de ACE Music v1 a partir de un prompt, “Let the 44 Roll By”, está en el recorrido paso a paso. Dos prompts más, con los otros dos modelos:
An anthemic Celtic folk-rock singalong about a fishing crew racing a storm back
to the harbor. Fiddle and tin whistle hooks, stomping kick drum, bodhran, a
gravelly male lead and the whole crew shouting the chorus.
ACE Music v1.1 Preview — “Haul for the Harbor Light” · 2:51 · generada en 43 s
Mostrar la llamada a la API
curl -X POST 'https://api.useapi.net/v1/acemusic/music' \
-H 'Authorization: Bearer user:12345-…' \
-H 'Content-Type: application/json' \
-d '{
"prompt": "An anthemic Celtic folk-rock singalong about a fishing crew racing a storm back to the harbor. Fiddle and tin whistle hooks, stomping kick drum, bodhran, a gravelly male lead and the whole crew shouting the chorus.",
"model": "acemusic-v1.1",
"async": true
}'
A breezy bossa nova for a lazy Sunday afternoon in Lisbon: nylon-string guitar,
soft brushed snare, upright bass, a gentle flute line and a warm male and female
duet sung in Portuguese.
ACE-Step v1.5 XL, sin créditos — “Domingo em Alfama” · 3:28
Mostrar la llamada a la API
curl -X POST 'https://api.useapi.net/v1/acemusic/music' \
-H 'Authorization: Bearer user:12345-…' \
-H 'Content-Type: application/json' \
-d '{
"prompt": "A breezy bossa nova for a lazy Sunday afternoon in Lisbon: nylon-string guitar, soft brushed snare, upright bass, a gentle flute line and a warm male and female duet sung in Portuguese.",
"model": "ace-step-1.5-xl",
"async": true
}'
Tu propia letra
Dos estrofas, un pre-coro, un puente y un outro escritos por nosotros, con una duración pedida de 210 segundos:
Style: cinematic indie pop ballad, felt piano, swelling strings, deep heartbeat
kick, intimate female vocal that opens up into a soaring chorus, 72 bpm
Lyrics: [Verse 1] We wrote our names on paper lanterns / Down by the river in July …
[Chorus] Light it up and let it go / Every word I never said out loud …
ACE Music v1 — “Paper Lanterns” · 3:29 · generada en 61 s
Mostrar la llamada a la API
curl -X POST 'https://api.useapi.net/v1/acemusic/music' \
-H 'Authorization: Bearer user:12345-…' \
-H 'Content-Type: application/json' \
-d '{
"title": "Paper Lanterns",
"style": "cinematic indie pop ballad, felt piano, swelling strings, deep heartbeat kick, intimate female vocal that opens up into a soaring chorus, 72 bpm",
"lyrics": "[Verse 1]\nWe wrote our names on paper lanterns\nDown by the river in July\nYou said the wind would know the answer\nIf we just let the fire fly\nYour hand was shaking, mine was steady\nAt least that'\''s how I tell it now\nWe watched them climb until the city\nWas just a glow beneath the clouds\n\n[Pre-Chorus]\nSo every summer I come back here\nStrike a match and hold it near\n\n[Chorus]\nLight it up and let it go\nEvery word I never said out loud\nLight it up and let it go\nHigher than the both of us somehow\nAnd if it finds you anyhow\nTell me you can see it from the clouds\n\n[Verse 2]\nThey tore the old pier down last winter\nPut up a fence and painted lines\nBut I still know the way by heartbeat\nI find the water every time\nI keep a lighter in my pocket\nI keep your laugh inside my head\nI fold the paper like you showed me\nAnd write the things I should have said\n\n[Pre-Chorus]\nSo every summer I come back here\nStrike a match and hold it near\n\n[Chorus]\nLight it up and let it go\nEvery word I never said out loud\nLight it up and let it go\nHigher than the both of us somehow\nAnd if it finds you anyhow\nTell me you can see it from the clouds\n\n[Bridge]\nPaper and fire, paper and fire\nNothing this light should rise so high\nPaper and fire, paper and fire\nMaybe that'\''s how we say goodbye\n\n[Final Chorus]\nLight it up and let it go\nEvery word I never said out loud\nLight it up and let it go\nHigher than the both of us somehow\n\n[Outro]\nDown by the river in July",
"model": "acemusic-v1",
"duration": 210,
"async": true
}'
Un instrumental: instrumental: true, 150 segundos y sin voces, coro ni guitarra acústica:
Style: cinematic synthwave instrumental for a night drive: pulsing analog bass
arpeggio, gated reverb drums, lush pads, a soaring lead synth melody,
builds to a big final section, 108 bpm
ACE Music v1 — “Neon Overpass” · 2:29 · generada en 46 s
Mostrar la llamada a la API
curl -X POST 'https://api.useapi.net/v1/acemusic/music' \
-H 'Authorization: Bearer user:12345-…' \
-H 'Content-Type: application/json' \
-d '{
"title": "Neon Overpass",
"style": "cinematic synthwave instrumental for a night drive: pulsing analog bass arpeggio, gated reverb drums, lush pads, a soaring lead synth melody, builds to a big final section, 108 bpm",
"instrumental": true,
"model": "acemusic-v1",
"duration": 150,
"negative": "vocals, choir, acoustic guitar",
"async": true
}'
Una letra en español sobre una fiesta en la azotea durante un apagón:
Style: modern cumbia pop, bright accordion hooks, güira and congas, warm bass,
a festive male lead with a crowd shouting the chorus, 98 bpm
Lyrics: [Chorus] Bailando en la azotea / Con las estrellas de farol …
ACE Music v1 — “Bailando en la Azotea” · 2:32 · generada en 46 s
Mostrar la llamada a la API
curl -X POST 'https://api.useapi.net/v1/acemusic/music' \
-H 'Authorization: Bearer user:12345-…' \
-H 'Content-Type: application/json' \
-d '{
"title": "Bailando en la Azotea",
"style": "modern cumbia pop, bright accordion hooks, güira and congas, warm bass, a festive male lead with a crowd shouting the chorus, 98 bpm",
"lyrics": "[Verse 1]\nSe fue la luz en todo el barrio\nY nadie quiere irse a dormir\nDoña Rosa saca el radio viejo\nY la noche empieza a sonreír\nLos vecinos suben con sus sillas\nAlguien trae limones y café\nY la ciudad allá abajo, oscura\nNos mira bailar sin saber por qué\n\n[Pre-Chorus]\nSube, sube, que la luna está invitando\nSube, sube, que la calle está cantando\n\n[Chorus]\nBailando en la azotea\nCon las estrellas de farol\nQue se entere todo el mundo\nQue esta noche no hay apagón\nBailando en la azotea\nCon el corazón de tambor\nSi se apaga la ciudad entera\nAquí arriba sobra amor\n\n[Verse 2]\nEl abuelo saca la guitarra\nLa vecina de enfrente se animó\nLos niños corren entre las sábanas\nQue el viento de la tarde colgó\nNadie sabe cuándo vuelve la corriente\nY la verdad, a nadie le importó\nEsta fiesta no la paga nadie\nEsta fiesta la invitó el apagón\n\n[Chorus]\nBailando en la azotea\nCon las estrellas de farol\nQue se entere todo el mundo\nQue esta noche no hay apagón\nBailando en la azotea\nCon el corazón de tambor\nSi se apaga la ciudad entera\nAquí arriba sobra amor\n\n[Outro]\nQue esta noche no hay apagón",
"model": "acemusic-v1",
"async": true
}'
Letra del generador de letras, estilo del generador de estilos, cantada por ACE-Step:
Lyrics writer: A wistful country song about an old pickup truck that still has
her mixtape stuck in the tape deck
Style writer: classic country ballad, pedal steel, warm baritone
ACE-Step v1.5 XL, sin créditos — “Side B Forever” · 3:35 · generada en 40 s, después de 6 s para la letra y 4 s para el estilo
Mostrar la llamada a la API
curl -X POST 'https://api.useapi.net/v1/acemusic/music/lyrics' \
-H 'Authorization: Bearer user:12345-…' \
-H 'Content-Type: application/json' \
-d '{
"prompt": "A wistful country song about an old pickup truck that still has her mixtape stuck in the tape deck",
"style": "classic country ballad, pedal steel, warm baritone",
"model": "ace-step-1.5-xl"
}' > lyrics.json
curl -X POST 'https://api.useapi.net/v1/acemusic/music/style' \
-H 'Authorization: Bearer user:12345-…' \
-H 'Content-Type: application/json' \
-d '{
"style": "classic country ballad, pedal steel, warm baritone",
"model": "ace-step-1.5-xl"
}' > style.json
# sing what the writers returned
jq -n --slurpfile l lyrics.json --slurpfile s style.json \
'{title: $l[0].title, lyrics: $l[0].lyrics, style: $s[0].style, model: "ace-step-1.5-xl", async: true}' |
curl -X POST 'https://api.useapi.net/v1/acemusic/music' \
-H 'Authorization: Bearer user:12345-…' \
-H 'Content-Type: application/json' \
-d @-
ACE-Step con tempo, tonalidad y compás fijos
Cada una volvió exactamente con la duración pedida.
3/4 · 84 bpm · D minor · 120 s · thinking 60 · avoid: trap drums, EDM, autotune
Style: dark cabaret waltz, accordion, pizzicato strings, upright bass, brushed
snare, theatrical female vocal
ACE-Step v1.5 XL, sin créditos — “Midnight Waltz” · 2:00 · generada en 31 s
Mostrar la llamada a la API
curl -X POST 'https://api.useapi.net/v1/acemusic/music' \
-H 'Authorization: Bearer user:12345-…' \
-H 'Content-Type: application/json' \
-d '{
"model": "ace-step-1.5-xl",
"title": "Midnight Waltz",
"style": "dark cabaret waltz, accordion, pizzicato strings, upright bass, brushed snare, theatrical female vocal",
"lyrics": "[Verse 1]\nThe band plays slow when the lights go low\nAnd the chandeliers begin to sway\nTake my hand, we will dance till the candles stand\nIn puddles of yesterday\n\n[Chorus]\nOne, two, three, turn around with me\nRound and round till the morning comes\nOne, two, three, oh don'\''t let me be\nThe last one dancing when the music'\''s done\n\n[Verse 2]\nThe clock strikes twelve and it laughs at itself\nEvery mirror wears a stranger'\''s face\nHold me close, we are only ghosts\nWho forgot to leave this place\n\n[Chorus]\nOne, two, three, turn around with me\nRound and round till the morning comes\nOne, two, three, oh don'\''t let me be\nThe last one dancing when the music'\''s done",
"bpm": 84,
"timeSignature": "3/4",
"key": "D minor",
"duration": 120,
"negative": "trap drums, EDM, autotune",
"thinking": 60,
"async": true
}'
6/8 · 116 bpm · G major · 90 s · instrumental
Style: lively celtic instrumental jig, fiddle and tin whistle trading the melody,
bodhran, strummed bouzouki, foot stomps
ACE-Step v1.5 XL, sin créditos — “Harbour Jig” · 1:30 · generada en 20 s
Mostrar la llamada a la API
curl -X POST 'https://api.useapi.net/v1/acemusic/music' \
-H 'Authorization: Bearer user:12345-…' \
-H 'Content-Type: application/json' \
-d '{
"model": "ace-step-1.5-xl",
"title": "Harbour Jig",
"style": "lively celtic instrumental jig, fiddle and tin whistle trading the melody, bodhran, strummed bouzouki, foot stomps",
"instrumental": true,
"bpm": 116,
"timeSignature": "6/8",
"key": "G major",
"duration": 90,
"async": true
}'
4/4 · 174 bpm · F minor · 150 s · thinking 80
Style: liquid drum and bass, rolling breakbeats, deep warm sub bass, airy pads,
soulful female vocal
ACE-Step v1.5 XL, sin créditos — “Almost Home” · 2:30 · generada en 41 s
Mostrar la llamada a la API
curl -X POST 'https://api.useapi.net/v1/acemusic/music' \
-H 'Authorization: Bearer user:12345-…' \
-H 'Content-Type: application/json' \
-d '{
"model": "ace-step-1.5-xl",
"title": "Almost Home",
"style": "liquid drum and bass, rolling breakbeats, deep warm sub bass, airy pads, soulful female vocal",
"lyrics": "[Verse]\nCity lights in the rear view mirror\nRunning on a borrowed night\nEvery bridge is a little bit nearer\nEvery tunnel full of light\n\n[Chorus]\nHold on, we'\''re almost home\nEvery signal turning green\nHold on, you'\''re not alone\nFaster than the in-between\n\n[Verse]\nRadio low and the windows open\nBreathing in the summer rain\nEvery promise we left unspoken\nRushing back to us again\n\n[Chorus]\nHold on, we'\''re almost home\nEvery signal turning green\nHold on, you'\''re not alone\nFaster than the in-between",
"bpm": 174,
"timeSignature": "4/4",
"key": "F minor",
"duration": 150,
"thinking": 80,
"async": true
}'
Un cover, un remix y una edición
“Paper Lanterns” como cover, con un estilo nuevo que conserva su melodía:
mode: cover · stripped-back acoustic folk cover, fingerpicked steel-string guitar,
warm cello, soft close-mic'd male vocal
ACE Music v1.1 Preview — “Paper Lanterns (Acoustic Folk Cover)” · 3:34 · generada en 72 s
Mostrar la llamada a la API
# our script read the score first (free for an ACE Music v1 song; the API now does this by itself)
curl 'https://api.useapi.net/v1/acemusic/music/score?songId=user%3A12345-example%40example.com-song%3Aso_4e7b2c9d0a5f4183b6d8e2c7' \
-H 'Authorization: Bearer user:12345-…' > /dev/null
curl -X POST 'https://api.useapi.net/v1/acemusic/music' \
-H 'Authorization: Bearer user:12345-…' \
-H 'Content-Type: application/json' \
-d '{
"mode": "cover",
"model": "acemusic-v1.1",
"references": ["user:[email protected]:so_4e7b2c9d0a5f4183b6d8e2c7"],
"style": "stripped-back acoustic folk cover, fingerpicked steel-string guitar, warm cello, soft close-mic'\''d male vocal",
"async": true
}'
“Bailando en la Azotea” en versión deep house. No enviamos título, así que ACE Music la llamó “Reference 1”:
mode: remix · coverStrength 40 · remixStrength 50 · deep house remix,
four-on-the-floor kick, plucky chords, rolling bassline, filtered vocal chops
ACE-Step v1.5 XL, sin créditos — “Reference 1” · 2:32 · generada en 31 s
Mostrar la llamada a la API
curl -X POST 'https://api.useapi.net/v1/acemusic/music' \
-H 'Authorization: Bearer user:12345-…' \
-H 'Content-Type: application/json' \
-d '{
"mode": "remix",
"model": "ace-step-1.5-xl",
"references": ["user:[email protected]:so_9d3b7e2c1a6f4085b8e4d1c6"],
"style": "deep house remix, four-on-the-floor kick, plucky chords, rolling bassline, filtered vocal chops",
"coverStrength": 40,
"remixStrength": 50,
"async": true
}'
“Paper Lanterns” con letra nueva entre los segundos 30 y 50, y el resto intacto:
mode: edit · start 30 · end 50
Lyrics: We wrote our names on paper lanterns / Down by the harbor in the snow /
You said the stars would keep the answer / If we were brave enough to go
ACE-Step v1.5 XL, sin créditos — “Reference 1” · 3:29 · generada en 41 s
Mostrar la llamada a la API
curl -X POST 'https://api.useapi.net/v1/acemusic/music' \
-H 'Authorization: Bearer user:12345-…' \
-H 'Content-Type: application/json' \
-d '{
"mode": "edit",
"model": "ace-step-1.5-xl",
"references": ["user:[email protected]:so_4e7b2c9d0a5f4183b6d8e2c7"],
"start": 30,
"end": 50,
"style": "cinematic indie pop ballad, felt piano, swelling strings, intimate female vocal",
"lyrics": "We wrote our names on paper lanterns\nDown by the harbor in the snow\nYou said the stars would keep the answer\nIf we were brave enough to go",
"async": true
}'
Mashups
“Paper Lanterns” y “Let the 44 Roll By”:
upbeat neo-soul pop mashup, punchy live drums, warm Rhodes and strings, female
lead with a gospel-tinged choir on the chorus · audioInfluence 60
ACE Music v1.1 Preview — “Lanterns at the Bus Stop” · 3:58 · generada en 83 s
Mostrar la llamada a la API
# our script read each song's score first (the API now does this by itself for ACE Music v1 songs)
curl -X POST 'https://api.useapi.net/v1/acemusic/music' \
-H 'Authorization: Bearer user:12345-…' \
-H 'Content-Type: application/json' \
-d '{
"mode": "mashup",
"model": "acemusic-v1.1",
"references": ["user:[email protected]:so_4e7b2c9d0a5f4183b6d8e2c7", "user:[email protected]:so_7c1d9e3a5b2f4806a4e1c9d3"],
"title": "Lanterns at the Bus Stop",
"style": "upbeat neo-soul pop mashup, punchy live drums, warm Rhodes and strings, female lead with a gospel-tinged choir on the chorus",
"audioInfluence": 60,
"async": true
}'
“Haul for the Harbor Light” y “Bailando en la Azotea”, pedidos con ACE Music v1:
festive celtic cumbia mashup, fiddle and accordion trading hooks, congas and
bodhran, stomping kick, male lead with a big crowd chorus
ACE Music v1.1 Preview (pedido: v1) — “Harbor Fiesta” · 2:38 · generada en 74 s
Mostrar la llamada a la API
# our script read each song's score first (the API now does this by itself for ACE Music v1 songs)
curl -X POST 'https://api.useapi.net/v1/acemusic/music' \
-H 'Authorization: Bearer user:12345-…' \
-H 'Content-Type: application/json' \
-d '{
"mode": "mashup",
"model": "acemusic-v1",
"references": ["user:[email protected]:so_2a8f6c1e9d4b47f3b0c5e8a2", "user:[email protected]:so_9d3b7e2c1a6f4085b8e4d1c6"],
"title": "Harbor Fiesta",
"style": "festive celtic cumbia mashup, fiddle and accordion trading hooks, congas and bodhran, stomping kick, male lead with a big crowd chorus",
"async": true
}'
Tres canciones a la vez: “Paper Lanterns”, “Bailando en la Azotea” y “Let the 44 Roll By”:
warm late-night soul-pop medley, Rhodes and strings, light latin percussion,
female lead with a male answer on the last chorus
ACE Music v1.1 Preview — “Three Songs, One Night” · 3:32 · generada en 43 s
Mostrar la llamada a la API
# our script read each song's score first (the API now does this by itself for ACE Music v1 songs)
curl -X POST 'https://api.useapi.net/v1/acemusic/music' \
-H 'Authorization: Bearer user:12345-…' \
-H 'Content-Type: application/json' \
-d '{
"mode": "mashup",
"model": "acemusic-v1.1",
"references": ["user:[email protected]:so_4e7b2c9d0a5f4183b6d8e2c7", "user:[email protected]:so_9d3b7e2c1a6f4085b8e4d1c6", "user:[email protected]:so_7c1d9e3a5b2f4806a4e1c9d3"],
"title": "Three Songs, One Night",
"style": "warm late-night soul-pop medley, Rhodes and strings, light latin percussion, female lead with a male answer on the last chorus",
"async": true
}'
Tu audio y tus imágenes
El “Harbour Jig” de arriba, subido como MP3 y usado como referencia de un prompt. ACE Music lo ejecutó con v1.1 para conservar la melodía:
A rowdy pub singalong with a big shouted chorus about the last ferry home, built
on the tune of this recording
ACE Music v1.1 Preview (pedido: v1) — “Last Ferry Home” · 1:36 · generada en 52 s
Mostrar la llamada a la API
curl -X POST 'https://api.useapi.net/v1/acemusic/files?title=Harbour%20Jig%20demo' \
-H 'Authorization: Bearer user:12345-…' \
-H 'Content-Type: audio/mpeg' \
--data-binary @harbour-jig-demo.mp3
curl -X POST 'https://api.useapi.net/v1/acemusic/music' \
-H 'Authorization: Bearer user:12345-…' \
-H 'Content-Type: application/json' \
-d '{
"prompt": "A rowdy pub singalong with a big shouted chorus about the last ferry home, built on the tune of this recording",
"model": "acemusic-v1",
"references": ["user:[email protected]:so_5f1a3c8e7b2d49a6c3e0f7b9"],
"async": true
}'
Stems de “Paper Lanterns”
La voz y el instrumental de mode: "vocals" (5 créditos), y luego la batería y las cuerdas de los 9 stems de mode: "all" (60 créditos).
Mostrar la llamada a la API
curl -X POST 'https://api.useapi.net/v1/acemusic/music/stems' \
-H 'Authorization: Bearer user:12345-…' \
-H 'Content-Type: application/json' \
-d '{
"songId": "user:[email protected]:so_4e7b2c9d0a5f4183b6d8e2c7",
"mode": "vocals",
"async": true
}'
curl -X POST 'https://api.useapi.net/v1/acemusic/music/stems' \
-H 'Authorization: Bearer user:12345-…' \
-H 'Content-Type: application/json' \
-d '{
"songId": "user:[email protected]:so_4e7b2c9d0a5f4183b6d8e2c7",
"mode": "all",
"async": true
}'
Preguntas
¿Existe una API de ACE Music?
Con useapi.net, sí: la ACE Music API ejecuta ACE Music v1, ACE Music v1.1 Preview y ACE-Step v1.5 XL por REST con tu cuenta de ACE Music, con covers, mashups, stems y MIDI. ACE Music v1 y v1.1 no tienen una API pública propia (a noviembre de 2026), así que useapi.net es la única forma de usarlos desde código. La API propia de ACE Music ejecuta el modelo anterior, ACE-Step v1.5, y pausó los registros de nuevas claves de API.
¿Existe una API gratuita de ACE-Step?
Con useapi.net, sí: una canción de ACE-Step v1.5 XL no gasta créditos en ningún plan de ACE Music, incluido el plan Free, con ajustes de tempo, tonalidad, compás y duración, remixes y ediciones. El sitio de terceros acestep.io ofrece su API de ACE-Step solo en su plan Studio de US$49 al mes, unos US$0,14 por canción (a noviembre de 2026).
¿Cuánto cuesta una canción de ACE Music v1 con la API?
Con useapi.net, una canción de ACE Music v1 cuesta 2 créditos de tu plan de ACE Music: US$0,013 en Artist con pago anual y US$0,023 en Artist con pago mensual, sin nada agregado por canción. ACE Music v1 no se vende a través de ninguna API pública (a noviembre de 2026), así que los créditos de tu plan son la única forma de pagarlo por canción desde código. Consulta Precios.
¿Existe un servidor MCP de ACE Music?
Con useapi.net, sí: un servidor MCP de ACE Music alojado, con 15 herramientas, permite que la app de Claude, ChatGPT, Claude Code y Cursor creen canciones, covers, mashups y stems con tu cuenta de ACE Music, sin nada que instalar. ACE Music no ofrece una integración MCP pública propia (a noviembre de 2026).
Conclusión
Un POST genera dos canciones con el modelo que encabeza el ranking vocal, las canciones de ACE-Step no cuestan nada, y cada canción puede convertirse en un cover, un mashup, stems o un archivo MIDI en la siguiente llamada. Clona el repositorio acemusic-api, ejecuta songs-from-prompt/ con --only 3 en una cuenta Free y consulta POST /music para ver todas las opciones.
Visita nuestro servidor de Discord o nuestro
canal de Telegram para cualquier pregunta de soporte.