Como gerar músicas com IA pela API do ACE Music

22 min de leitura • 14 de novembro de 2026

Sumário

  1. Introdução
  2. Modelos e o que a API faz
  3. Preços
  4. Como gerar uma música com curl
    1. Adicione a sua conta do ACE Music
    2. Gere músicas a partir de um prompt
    3. O que você recebe
    4. Síncrono, assíncrono e webhooks
  5. Cante a sua própria letra
  6. Controle andamento, tom e compasso com o ACE-Step
  7. Covers, remixes e edições
    1. Faça um mashup de duas ou três músicas
  8. Guie as músicas com o seu próprio áudio e imagens
  9. Stems, downloads e a partitura
    1. Separe uma música em stems
    2. Baixe MP3, WAV, MIDI e MusicXML
    3. Leia a partitura
  10. A sua Biblioteca
  11. Várias contas do ACE Music
  12. Use pelo Claude, ChatGPT ou Cursor (MCP)
  13. Gere em lote com os scripts
  14. Exemplos
    1. Uma música a partir de uma imagem
    2. Músicas a partir de um prompt
    3. A sua própria letra
    4. ACE-Step com andamento, tom e compasso definidos
    5. Um cover, um remix e uma edição
    6. Mashups
    7. O seu áudio e as suas imagens
    8. Stems de “Paper Lanterns”
  15. Perguntas
  16. Conclusão

Introdução

A API do ACE Music da useapi.net transforma uma única chamada REST em duas músicas prontas do ACE Music, com vocais, letra, título e capa, na assinatura do ACE Music que você já tem. O ACE Music v1 está em 1º lugar no ranking de música vocal da Artificial Analysis, à frente do Suno v6, e o ACE Music v1 e o v1.1 não têm API pública própria (em novembro de 2026), então a useapi.net é a única forma de chamá-los por código. O ACE-Step v1.5 XL, de código aberto, roda pela mesma API sem gastar créditos em nenhum plano do ACE Music, inclusive no plano Free.

Este guia começa pelos três modelos e pelo custo de uma música, faz uma música do início ao fim com curl e depois cobre todos os outros recursos numa tabela curta. Os Exemplos no final são 18 músicas que fizemos para esta página, cada uma com a requisição que a gerou, todas com os scripts do repositório acemusic-api no GitHub (Node.js e Python), por 117 créditos de um plano Artist, com as tomadas extras. A useapi.net é uma API de terceiros, sem afiliação com o ACE Music nem com a Timedomain, a empresa que o criou.

Modelos e o que a API faz

Toda requisição gera duas músicas, e model escolhe quem as faz:

Modelo model Para que serve Ajustes Créditos por requisição Tempo nos testes
ACE Music v1 acemusic-v1 (padrão) O modelo vocal nº 1: músicas a partir de um prompt ou da sua letra, cantadas ou instrumentais duration de 30 a 600 s, negative, styleInfluence, downloads em WAV 4 46 a 89 s
ACE Music v1.1 Preview acemusic-v1.1 Escreve primeiro uma partitura, então os covers e mashups seguem a melodia da música audioInfluence, styleInfluence 4 35 a 83 s
ACE-Step v1.5 XL ace-step-1.5-xl Código aberto, da ACE Studio e da StepFun: músicas, remixes e edições bpm, key, timeSignature, duration de 10 a 240 s, negative, thinking. Só MP3 0 20 a 55 s

O que dá para fazer com eles:

O quê Requisição Observações
Músicas a partir de um prompt POST /music prompt O ACE Music escreve o estilo, a letra e o título
Sua própria letra, instrumentais POST /music style, lyrics Qualquer idioma
Geradores de letra e de estilo POST /music/lyrics, /music/style Sem créditos
Covers, remixes, edições, mashups POST /music mode Em qualquer música da conta
Seu áudio e suas imagens POST /files Como referências para novas músicas
Stems POST /music/stems Creator e Artist
Downloads, partitura GET /music/download, /music/score MP3 e a partitura em todos os planos, WAV, MIDI e MusicXML no Creator e no Artist
Biblioteca, jobs, contas GET /music, /jobs, /accounts Todas as músicas da conta, jobs em andamento, créditos ao vivo
Servidor MCP /v1/acemusic/mcp 15 ferramentas para assistentes de IA

Preços

O ACE Music cobra créditos próprios por requisição, do seu plano do ACE Music, e a useapi.net não acrescenta nada por música (em novembro de 2026):

Requisição Créditos
Duas músicas no ACE Music v1 ou v1.1 4
Stems, vocal + instrumental 5, planos pagos
Stems, todos os stems 60, planos pagos
Partitura de uma música do ACE-Step, primeira leitura 1
Duas músicas no ACE-Step v1.5 XL 0, em todos os planos
Geradores de letra e de estilo, uploads, downloads 0 nos nossos testes

Os planos do ACE Music são o Free, com 20 créditos por dia, o Creator, a $9,90 por mês por 1.000 créditos, e o Artist, a $29 por mês por 2.500 créditos, ou $7,90 e $16,58 por mês com cobrança anual. Uma música é meia requisição, 2 créditos. A visão geral da API tem a mesma tabela.

Quanto custa uma música em cada plano, do mais barato à esquerda (uma requisição gera duas músicas, então uma música custa metade dos créditos da requisição; em novembro de 2026):

Modelo Free
20 cr/dia		 Artist $16,58/mês
2.500 cr/mês, cobrança anual		 Creator $7,90/mês
1.000 cr/mês, cobrança anual		 Creator $9,90/mês
1.000 cr/mês		 Artist $29/mês
2.500 cr/mês
ACE Music v1, v1.1
uma música		 $0 / 2 cr
10 músicas/dia		 $0,013 / 2 cr
1.250/mês		 $0,016 / 2 cr
500/mês		 $0,020 / 2 cr
500/mês		 $0,023 / 2 cr
1.250/mês
Stems
vocal + instrumental		 planos pagos $0,033 / 5 cr $0,040 / 5 cr $0,050 / 5 cr $0,058 / 5 cr
Stems
todos os stems		 planos pagos $0,40 / 60 cr $0,47 / 60 cr $0,59 / 60 cr $0,70 / 60 cr
Partitura ACE-Step
primeira leitura		 $0 / 1 cr $0,007 / 1 cr $0,008 / 1 cr $0,010 / 1 cr $0,012 / 1 cr
ACE-Step v1.5 XL
uma música		 $0 / 0 cr $0 / 0 cr $0 / 0 cr $0 / 0 cr $0 / 0 cr

Como isso se compara com as outras formas de chamar esses modelos por código:

Modelo useapi.net Outras APIs
ACE Music v1, v1.1 Preview a partir de $0,013 por música no Artist com cobrança anual, $0 nos 20 créditos diários do plano Free nenhuma: o ACE Music não oferece API pública para eles
ACE-Step v1.5 XL $0 em todos os planos do ACE Music, inclusive no Free cerca de $0,14 por música na API da acestep.io, de terceiros, que exige o plano Studio de $49 por mês

Em qualquer plano do ACE Music, inclusive no Free, uma música do ACE-Step v1.5 XL não gasta créditos, contra a API da acestep.io, de terceiros, que exige o plano Studio de $49 por mês (cerca de 360 músicas por mês, cerca de $0,14 por música, em novembro de 2026).

Comece a usar a API

Uma assinatura de US$ 15 por mês dá acesso a todas as APIs da useapi.net: um token, todos os serviços. Você conecta até 3 contas suas por serviço, e a useapi.net cuida da API REST, do balanceamento de carga e do polling. Precisa de mais contas? Cada assinatura extra custa US$ 10 por mês e acrescenta mais 3 contas por serviço.

Assinar — US$ 15/mês Pagar com cripto

Não tem cartão de crédito internacional? Você também pode assinar com criptomoedas (pagamentos em cripto não são reembolsáveis). Preços e planos de volume estão na página de assinatura. Pagando pelo Stripe, você recebe reembolso integral em até 14 dias após a primeira compra, se tiver menos de 50 gerações bem-sucedidas. Já é assinante? Altere a quantidade no portal do cliente Stripe em vez de comprar de novo.

Como gerar uma música com curl

Você precisa de um token da API da useapi.net, veja o Setup useapi.net, e de uma conta do ACE Music com e-mail e senha. Uma assinatura de $15 por mês cobre todas as APIs da useapi.net e 3 contas do ACE Music. Uma conta Free do ACE Music funciona: ela ganha 20 créditos por dia, e as músicas do ACE-Step não gastam nenhum. Os comandos usam o jq para ler o JSON.

Adicione a sua conta do ACE Music

Exporte o token e adicione a conta uma única vez. A API faz login, lê a conta e só a salva se o ACE Music aceitar a senha:

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" }'

Uma conta criada com Continue with Google ou com um número de telefone precisa primeiro de uma senha, veja o Setup ACE Music, que também pode adicioná-la para você.

Gere músicas a partir de um prompt

Descreva a música com as suas palavras. O ACE Music escreve o estilo, a letra e o título e depois gera duas músicas. Esta é a requisição exata por trás da primeira música desta 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}'

Com async: true a API responde 201 na hora, com o job. Um prompt pode ter até 2.000 caracteres e levar até 3 músicas de referência e 3 imagens, veja Guie as músicas com o seu próprio áudio e imagens.

O que você recebe

Enquanto o ACE Music escreve a letra, as músicas ficam em planning e Untitled, depois em queued e running. Consulte GET /jobs/jobid a cada 10 segundos, mais ou menos. O jobid contém : e @, então codifique-o para 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}]}'

Quando status for completed, cada música traz os seus links (os ids abaixo são 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"
}
  • audioUrl é o link público do MP3 da música e nunca muda. playUrl é um link direto para o mesmo MP3, para players na web, válido até playUrlExpires (cerca de uma hora): alguns navegadores, como o Brave, bloqueiam o redirecionamento por trás do audioUrl.
  • songId é o que covers, mashups, stems, downloads e a partitura recebem. Ele identifica a conta em que a música está, então essas chamadas rodam nela.
  • model é o modelo que você pediu, e modelUsed o que rodou (veja mashups). kind é original, cover, edit, mashup ou upload, e score diz se a música já tem a partitura.
  • Uma música que o ACE Music não conseguiu gerar tem status: "failed", o motivo do ACE Music em error e refunded: true quando os créditos voltaram.

E aqui está a primeira dessas duas músicas:

ACE Music v1 — “Let the 44 Roll By” · 4:37 · gerada em 89 s

Síncrono, assíncrono e webhooks

Você envia O POST responde Depois
async: true 201 na hora, com o job Consulte GET /jobs/jobid
sem async 200 com o job pronto, o mesmo JSON de cima Leia as músicas na resposta. Uma requisição ainda em andamento depois de 100 segundos responde 202 com o job: consulte-o
replyUrl e replyRef como acima, tanto no modo síncrono quanto no assíncrono A sua URL https pública recebe um único POST com o job pronto, com o seu replyRef nele

A nossa requisição do ACE-Step sem async voltou em 37 segundos, e o webhook chegou 12 segundos depois de as músicas ficarem prontas. Um job pode ser lido por 7 dias, e um que ainda esteja rodando 30 minutos depois de começar falha com 504. O async-webhooks/ roda as três formas e inclui um pequeno receptor de webhook.

Mostrar a chamada da 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}]}'

Cante a sua própria letra

Envie style e lyrics em vez de prompt, e o ACE Music canta as suas palavras no seu estilo:

Campo O que faz Limites
style Gênero, instrumentos, clima, andamento e vocais 1.000 caracteres, 512 no ACE-Step
lyrics As suas palavras, em qualquer idioma, com as tags [Verse], [Chorus], [Bridge] 5.000 caracteres, 2.000 no ACE-Step
title O título das músicas. Sem ele, o ACE Music escolhe um 80 caracteres
instrumental true para não ter vocais. Um style sem lyrics faz o mesmo  
duration A duração em segundos 30 a 600 no ACE Music v1, 10 a 240 no ACE-Step
negative Estilos a evitar 200 caracteres, ACE Music v1 e ACE-Step
styleInfluence O quanto o estilo é seguido à risca 0 a 100, padrão 80, ACE Music v1 e v1.1

Nunca envie prompt junto com esses campos: a API responde 400 e diz o que tirar. A nossa balada, pedida com duration: 210, voltou com 210 e 209 segundos. Ela está nos Exemplos, com um instrumental e uma música em espanhol.

Ainda sem letra? O POST /music/lyrics escreve uma letra e um título a partir de um pedido, e o POST /music/style transforma poucas palavras num estilo completo. Os nossos voltaram em 6 e 4 segundos, sem cobrança de créditos. Script: custom-lyrics/.

Controle andamento, tom e compasso com o ACE-Step

O ACE-Step v1.5 XL aceita configurações musicais que os modelos do ACE Music não aceitam, e as músicas dele não gastam créditos:

Opção Valores
bpm 30 a 200
timeSignature 2/4, 3/4, 4/4, 6/8
key C major a B minor (C, C#, D, Eb, E, F, F#, G, Ab, A, Bb, B)
duration 10 a 240 segundos
negative estilos a evitar, até 200 caracteres
thinking 0 a 100: o ACE-Step planeja a música inteira primeiro, criativo com valores baixos, estável com valores altos

As três músicas que fizemos no ACE-Step, uma valsa em 3/4, uma jig em 6/8 e um drum and bass a 174 bpm, voltaram exatamente com a duração pedida (Exemplos). Essas opções só funcionam no mode generate com ace-step-1.5-xl, e em qualquer outro caso a API responde 400 Parameter bpm does not apply to mode generate on acemusic-v1. Script: ace-step-options/.

Covers, remixes e edições

mode transforma uma requisição em trabalho sobre músicas que você já tem. references recebe os songIds delas: músicas que a API gerou, músicas da sua Biblioteca ou os seus próprios uploads.

mode references Roda em Créditos O que faz
cover 1 música acemusic-v1.1, ou ACE-Step em ace-step-1.5-xl 4 / 0 A música num novo style, seguindo a melodia, os acordes e a estrutura dela
remix 1 música ace-step-1.5-xl 0 coverStrength preserva o original, remixStrength se afasta dele (0 a 100)
edit 1 música ace-step-1.5-xl 0 Reescreve o trecho entre start e end segundos com uma nova lyrics e mantém o resto
mashup 2 ou 3 músicas acemusic-v1.1 4 Uma música nova feita de várias, veja abaixo

O ACE Music v1.1 segue a melodia que lê da partitura de uma música. O nosso primeiro cover de uma música do ACE Music v1 ainda sem partitura falhou com ref_no_melody, e os 4 créditos voltaram, então agora a API lê primeiro a partitura de uma música do ACE Music v1, de graça, antes de um cover ou mashup no v1.1. As músicas do ACE-Step não são lidas automaticamente: se uma delas responder 400 com ref_no_melody, chame primeiro o GET /music/score nela (1 crédito) e envie a requisição de novo. Script: covers-remix-edit/.

Faça um mashup de duas ou três músicas

mode: "mashup" gera uma música a partir de 2 ou 3 músicas da mesma conta, combinando as letras delas, a menos que você envie lyrics. audioInfluence (0 a 100, padrão 60) define o quanto as músicas são seguidas. Um mashup precisa ler as músicas, então roda no ACE Music v1.1 Preview mesmo quando você pede o v1, como no site do ACE Music: o nosso “Harbor Fiesta” informa "model": "acemusic-v1" e "modelUsed": "acemusic-v1.1", e os créditos seguem o modelo que rodou. O mesmo acontece com um cover pedido no v1, com um prompt com mais de uma referência no ACE-Step e, às vezes, com um prompt com uma música de referência. Script: mashup/.

Guie as músicas com o seu próprio áudio e imagens

O POST /files recebe o arquivo como corpo bruto da requisição, com o Content-Type dele:

Upload Formatos Até Você recebe Use como
Áudio MP3, WAV, FLAC, OGG, M4A, AAC 100 MB, 8 minutos Um songId: uma música da Biblioteca, com a letra, o estilo, o andamento e a melodia transcritos pelo ACE Music Uma das até 3 references de um prompt, ou a música para fazer cover, remix, edição ou mashup
Imagem JPEG, PNG, WebP 10 MB Um mediaId Uma das até 3 images de um prompt: o ACE Music escreve uma música sobre ela 
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}'

O nosso upload de 90 segundos da “Harbour Jig” foi transcrito em 14 segundos, e o ACE Music ouviu 115 bpm (tínhamos pedido 116). A foto de um robô dançando virou um drum and bass sobre o pelo verde-azulado e os tênis de cano alto laranja dele. Os dois estão nos Exemplos. Os uploads contam na cota da conta: 10 minutos de áudio no Free, 30 no Creator e 60 no Artist. Script: upload-reference/.

Stems, downloads e a partitura

Toda música pronta pode ser separada em stems, baixada e lida como partitura:

Requisição Planos Créditos Você recebe
Stems, mode: "vocals" Creator, Artist 5 MP3s vocal e instrumental
Stems, mode: "all" Creator, Artist 60 Todos os stems que o ACE Music encontrar, em MP3
Download mp3 (padrão) todos os planos 0 url (o mesmo que audioUrl) e playUrl
Download wav Creator, Artist 0 Um link válido por 24 horas. Não vale para músicas do ACE-Step
Download midi, musicxml Creator, Artist 0 O próprio arquivo
Partitura todos os planos 0, ou 1 na primeira vez para uma música do ACE-Step Notação ABC: a melodia vocal, uma linha instrumental, os acordes e as seções

Separe uma música em stems

A separação vocal de “Paper Lanterns” levou cerca de 80 segundos, e a completa menos de 2 minutos, com 9 stems: voz, backing vocals, bateria, baixo, guitarra, teclado, cordas, synth e fx (ouça). Os links dos stems duram 24 horas, então leia a música de novo para ter links novos. Separar uma música de novo no mesmo modo responde na hora e não cobra nada.

Baixe MP3, WAV, MIDI e MusicXML

O ACE Music gera o WAV, o MIDI e o MusicXML no primeiro pedido: a API espera até um minuto e depois responde 202, então chame de novo um minuto depois. Para “Paper Lanterns”, os três ficaram prontos em segundos: um WAV de 40 MB, um arquivo MIDI de 8 KB e uma partitura MusicXML de 107 KB.

Mostrar a chamada da 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

Leia a partitura

Qualquer ferramenta de ABC transforma a partitura em notas na pauta. Para “Paper Lanterns”, ela leu 72 bpm, o andamento que pedimos no estilo. As músicas do ACE Music v1.1 já vêm com a partitura, e os covers e mashups do v1.1 a seguem, veja Covers, remixes e edições.

Mostrar a chamada da 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 salva os stems, todos os formatos de download e a partitura.

A sua Biblioteca

Toda música e todo upload da conta, feitos aqui ou em acemusic.ai, ficam na Biblioteca dela até serem apagados:

Requisição O que faz
GET /music Uma página de músicas, das mais novas para as mais antigas, com next para a página seguinte. email é obrigatório com mais de uma conta. As músicas de jobs com mais de 7 dias estão aqui
GET /music/songId Uma música com links novos, e os stems dela quando ela foi separada
DELETE /music/songId 204: a música vai para a lixeira da conta em acemusic.ai, e a API responde 404 para ela a partir daí
Mostrar a chamada da 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/.

Várias contas do ACE Music

Cada assinatura da useapi.net conecta 3 contas do ACE Music, até 100 no total. Uma requisição sem email vai para uma conta saudável com vaga livre, e uma que cita uma música, um upload ou uma imagem roda na conta onde ela está. Uma conta roda até maxJobs requisições ao mesmo tempo, 4 por padrão, o limite do próprio ACE Music. Com todas as contas ocupadas, a API responde 429 com Retry-After, e uma senha que o ACE Music recusa faz essa conta responder 596 até você adicioná-la de novo.

O GET /accounts/email lê ao vivo o plano, os créditos e o custo em créditos de cada recurso, e o POST /accounts só com email e maxJobs muda apenas o maxJobs. Script: accounts/.

Mostrar a chamada da 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 }'

Use pelo Claude, ChatGPT ou Cursor (MCP)

Os mesmos recursos estão num servidor MCP hospedado, com 15 ferramentas, de músicas, covers e mashups a stems, partituras e uploads. O ACE Music não oferece integração MCP pública própria (em novembro de 2026). No Claude Code é um único comando:

claude mcp add --transport http useapi-acemusic https://api.useapi.net/v1/acemusic/mcp --header "Authorization: Bearer YOUR_API_TOKEN"

O Cursor, o VS Code e o Windsurf usam a mesma URL e o mesmo header, e o app do Claude e o ChatGPT fazem login com OAuth, veja como usar no app do Claude ou no ChatGPT. Depois é só pedir em linguagem natural: “Write lyrics about a cat who loves rainy days and sing them as acoustic indie folk on ACE Music v1”.

Gere em lote com os scripts

O repositório acemusic-api no GitHub tem um exemplo por recurso, com link em cada seção acima: um script em Node.js e um gêmeo em Python, sem nada para instalar. Cada um lê as requisições de um prompts.json que você edita, roda até 4 ao mesmo tempo, consulta os jobs e salva na pasta output/ as duas músicas, as capas, o registro do job e um ledger.jsonl com os créditos gastos.

Você precisa do Node.js 21 ou mais recente ou do Python 3.8 ou mais recente. --only 3 roda o terceiro prompt abaixo, uma música do ACE-Step sem créditos, então funciona numa conta 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 salvo guarda os songIds das músicas, e --from <job>.json --pick 1 passa a música 1 para o próximo script fazer um cover, um mashup ou a separação em 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"
    }
]

Exemplos

Todas as músicas abaixo foram feitas em 14 de novembro de 2026 (PST) com os scripts do repositório numa conta Artist do ACE Music, sempre a primeira das duas músicas de cada requisição. Os títulos são do ACE Music, a menos que tenhamos definido um, os tempos vão da requisição até as duas músicas ficarem prontas, e as chamadas mostram ids inventados.

Uma música a partir de uma imagem

Entram uma imagem e uma frase de estilo, saem duas músicas prontas. Enviamos esta foto de um mascote robô dançando e pedimos drum and bass; o ACE Music escreveu a letra a partir do que viu: “Teal fur shaking on the concrete floor, orange high-tops squeaking by the studio door”.

Um mascote robô verde-azulado e peludo, com cabeça de caixa, antena e olhos que acendem, dançando de tênis de cano alto laranja

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 · gerada em 72 s

Mostrar a chamada da 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
  }'

Músicas a partir de um prompt

A música do ACE Music v1 feita a partir de um prompt, “Let the 44 Roll By”, está no passo a passo. Mais dois prompts, nos outros dois 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 · gerada em 43 s

Mostrar a chamada da 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, sem créditos — “Domingo em Alfama” · 3:28

Mostrar a chamada da 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
  }'

A sua própria letra

Duas estrofes, um pré-refrão, uma ponte e um final escritos por nós, com 210 segundos pedidos:

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 · gerada em 61 s

Mostrar a chamada da 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
  }'

Um instrumental: instrumental: true, 150 segundos, e sem vocais, coral nem violão:

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 · gerada em 46 s

Mostrar a chamada da 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
  }'

Letra em espanhol sobre uma festa num terraço durante um apagão:

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 · gerada em 46 s

Mostrar a chamada da 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 do gerador de letras, estilo do gerador de estilos, cantada pelo 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, sem créditos — “Side B Forever” · 3:35 · gerada em 40 s, depois de 6 s para a letra e 4 s para o estilo

Mostrar a chamada da 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 com andamento, tom e compasso definidos

Cada uma voltou exatamente com a duração 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, sem créditos — “Midnight Waltz” · 2:00 · gerada em 31 s

Mostrar a chamada da 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, sem créditos — “Harbour Jig” · 1:30 · gerada em 20 s

Mostrar a chamada da 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, sem créditos — “Almost Home” · 2:30 · gerada em 41 s

Mostrar a chamada da 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
  }'

Um cover, um remix e uma edição

“Paper Lanterns” como cover, num estilo novo que mantém a melodia:

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 · gerada em 72 s

Mostrar a chamada da 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” como deep house. Não enviamos título, então o ACE Music a chamou de “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, sem créditos — “Reference 1” · 2:32 · gerada em 31 s

Mostrar a chamada da 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” com letra nova entre os segundos 30 e 50, e o resto mantido:

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, sem créditos — “Reference 1” · 3:29 · gerada em 41 s

Mostrar a chamada da 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” e “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 · gerada em 83 s

Mostrar a chamada da 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” e “Bailando en la Azotea”, pedido no 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 · gerada em 74 s

Mostrar a chamada da 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
  }'

Três músicas de uma vez: “Paper Lanterns”, “Bailando en la Azotea” e “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 · gerada em 43 s

Mostrar a chamada da 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
  }'

O seu áudio e as suas imagens

A “Harbour Jig” de cima, enviada como MP3 e usada como referência de um prompt. O ACE Music rodou no v1.1 para manter a melodia:

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 · gerada em 52 s

Mostrar a chamada da 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”

O vocal e o instrumental do mode: "vocals" (5 créditos), depois a bateria e as cordas, dois dos 9 stems do mode: "all" (60 créditos).

Mostrar a chamada da 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
  }'

Perguntas

Existe uma API do ACE Music?
Pela useapi.net, sim: a API do ACE Music roda o ACE Music v1, o ACE Music v1.1 Preview e o ACE-Step v1.5 XL via REST na sua conta do ACE Music, com covers, mashups, stems e MIDI. O ACE Music v1 e o v1.1 não têm API pública própria (em novembro de 2026), então a useapi.net é a única forma de chamá-los por código. A API do próprio ACE Music roda o ACE-Step v1.5, mais antigo, e suspendeu o cadastro de novas chaves de API.

Existe uma API gratuita do ACE-Step?
Pela useapi.net, sim: uma música do ACE-Step v1.5 XL não gasta créditos em nenhum plano do ACE Music, inclusive no Free, com configurações de andamento, tom, compasso e duração, remixes e edições. A acestep.io, de terceiros, só oferece a API do ACE-Step no plano Studio de $49 por mês, cerca de $0,14 por música (em novembro de 2026).

Quanto custa uma música do ACE Music v1 pela API?
Pela useapi.net, uma música do ACE Music v1 custa 2 créditos do seu plano do ACE Music: $0,013 no Artist com cobrança anual e $0,023 no Artist mensal, sem nada a mais por música. O ACE Music v1 não é vendido por nenhuma API pública (em novembro de 2026), então os créditos do seu plano são a única forma de pagar por ele, música a música, por código. Veja Preços.

Existe um servidor MCP do ACE Music?
Pela useapi.net, sim: um servidor MCP do ACE Music hospedado, com 15 ferramentas, permite que o app do Claude, o ChatGPT, o Claude Code e o Cursor gerem músicas, covers, mashups e stems na sua conta do ACE Music, sem nada para instalar. O ACE Music não oferece integração MCP pública própria (em novembro de 2026).

Conclusão

Um POST gera duas músicas no modelo que lidera o ranking vocal, as músicas do ACE-Step não custam nada, e toda música pode virar um cover, um mashup, stems ou um arquivo MIDI na chamada seguinte. Clone o repositório acemusic-api, rode o songs-from-prompt/ com --only 3 numa conta Free e veja o POST /music para todas as opções.

Visite o nosso servidor no Discord ou o canal no Telegram para qualquer dúvida de suporte.