Áudio
ACE-Step Gerador de Música
Descreva um estilo, adicione a letra e baixe uma música com vocais. Texto para música grátis nos dispositivos que você conecta.
ACE-Step by ACE Studio and StepFun; Qwen3 Embedding by Alibaba Cloud
Licenças do modelo
ACE-Step v1.5 turbo DiT, lyric encoder and derived conditioning · MIT AND Apache-2.0
Retain MIT copyright/permission/disclaimer and applicable full Apache-2.0 terms, preserve upstream notices and identify modifications. Apache patent termination and trademark limitations apply.
ACE-Step v1.5 audio VAE decoder · MIT
Retain MIT copyright/permission/disclaimer, preserve upstream notices and identify modifications.
Qwen3 Embedding 0.6B text encoder and tokenizer · Apache-2.0
Retain full Apache-2.0 terms, preserve upstream notices and identify modifications. Apache patent termination and trademark limitations apply.
Referência da API
Enviar via REST
Use sua chave de API pessoal (msk_…) para criar tarefas desta carga de trabalho a partir das suas próprias ferramentas. As tarefas iniciadas dessa forma rodam nos mesmos dispositivos que você conectou em Seus dispositivos — pelo menos um deles precisa estar online.
https://cp.meshlabs.cloud/v1/organizations/jobsAutentique-se com X-Organization-Api-Key: msk_your_personal_api_key. O nome do cabeçalho é o mesmo das chaves de organização; as chaves pessoais usam o mesmo endpoint.
Corpo da solicitação
{
"workload_type": "ace-step-15-turbo-music",
"job_spec": {
"prompt": "A photorealistic lighthouse at dusk",
"vocalLanguage": "en",
"durationSec": 60,
"shift": 3
}
}Campos de job_spec
| Campo | Obrigatório | Padrão | Descrição |
|---|---|---|---|
prompt | Sim | — | Gênero, instrumentação, clima, caráter vocal. |
lyrics | Não | — | Opcional. Aceita marcações de estrutura como [verse] / [chorus] / [bridge]. Deixe em branco para uma faixa instrumental. |
vocalLanguage | Não | en | Código de idioma da letra, por exemplo en, zh, ja, es. Ignorado em faixas instrumentais. |
durationSec | Não | 60 | Duração da música. Se o trabalho omitir o campo, a execução usa 60 segundos. |
shift | Não | 3 | Cronograma de passos de tempo. O valor 3 favorece a fidelidade; o valor 1 favorece a aderência ao prompt. |
seed | Não | — | Omita para uma música aleatória; defina para reproduzir uma música. |
bpm | Não | — | Omita para deixar o modelo escolher. |
keyScale | Não | — | Por exemplo, C major ou A minor. Omita para deixar o modelo escolher. |
timeSignature | Não | — | Tempos por compasso, por exemplo 4 para 4/4 ou 3 para 3/4. |
cURL
curl -X POST https://cp.meshlabs.cloud/v1/organizations/jobs \
-H "X-Organization-Api-Key: msk_your_personal_api_key" \
-H "Content-Type: application/json" \
-d '{
"workload_type": "ace-step-15-turbo-music",
"job_spec": {
"prompt": "A photorealistic lighthouse at dusk",
"vocalLanguage": "en",
"durationSec": 60,
"shift": 3
}
}'https://cp.meshlabs.cloud/v1/organizations/jobs/{job_id}Consulte com a mesma chave de API até que status seja final (COMPLETED, FAILED, CANCELED ou MODERATION_BLOCKED). Quando a moderação de conteúdo está habilitada, as tarefas podem começar em MODERATION_PENDING antes de entrar na fila de computação. As tarefas concluídas incluem valores download_url pré-assinados em cada saída.
Resposta de criação
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"workload_type": "ace-step-15-turbo-music",
"status": "PENDING",
"job_spec_json": {
"prompt": "A photorealistic lighthouse at dusk",
"vocalLanguage": "en",
"durationSec": 60,
"shift": 3
},
"work_units": [],
"outputs": [],
"created_at": "2026-06-08T12:00:00Z",
"updated_at": "2026-06-08T12:00:00Z"
}Resposta de conclusão
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"workload_type": "ace-step-15-turbo-music",
"status": "COMPLETED",
"job_spec_json": {
"prompt": "A photorealistic lighthouse at dusk",
"vocalLanguage": "en",
"durationSec": 60,
"shift": 3
},
"work_units": [
{
"id": "…",
"index": 0,
"status": "COMPLETED"
}
],
"outputs": [
{
"id": "…",
"output_type": "<output type>",
"filename": "<output filename>",
"size_bytes": 524288,
"download_url": "<presigned output download URL>"
}
],
"created_at": "2026-06-08T12:00:00Z",
"updated_at": "<completion timestamp>"
}Descreva um estilo, adicione a letra (opcional) e baixe uma música com vocais cantados — até cerca de quatro minutos de áudio estéreo. Texto para música grátis nos dispositivos que você conecta. A primeira execução baixa o modelo; as músicas seguintes começam mais rápido.