Audio
Generatore di musica ACE-Step
Descrivi uno stile, aggiungi un testo e scarica una canzone con voce. Da testo a musica gratis sui dispositivi che colleghi.
ACE-Step by ACE Studio and StepFun; Qwen3 Embedding by Alibaba Cloud
Licenze del modello
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.
Riferimento API
Invia tramite REST
Usa la tua chiave API personale (msk_…) per creare job per questo workload dai tuoi strumenti. I job avviati in questo modo vengono eseguiti sugli stessi dispositivi che hai collegato in I tuoi dispositivi: almeno uno deve essere online.
https://cp.meshlabs.cloud/v1/organizations/jobsAutenticati con X-Organization-Api-Key: msk_your_personal_api_key. Il nome dell'intestazione corrisponde a quello delle chiavi dell'organizzazione; le chiavi personali usano lo stesso endpoint.
Corpo della richiesta
{
"workload_type": "ace-step-15-turbo-music",
"job_spec": {
"prompt": "A photorealistic lighthouse at dusk",
"vocalLanguage": "en",
"durationSec": 60,
"shift": 3
}
}Campi di job_spec
| Campo | Obbligatorio | Predefinito | Descrizione |
|---|---|---|---|
prompt | Sì | — | Genere, strumentazione, atmosfera, carattere della voce. |
lyrics | No | — | Facoltativo. Supporta i tag di struttura [verse] / [chorus] / [bridge]. Lascia vuoto per un brano strumentale. |
vocalLanguage | No | en | Codice lingua del testo, ad es. en, zh, ja, es. Ignorato per un brano strumentale. |
durationSec | No | 60 | Durata della canzone. Se il lavoro omette il campo, vengono usati 60 secondi. |
shift | No | 3 | Schedulazione dei timestep. 3 privilegia la fedeltà, 1 privilegia l'aderenza al prompt. |
seed | No | — | Omettilo per una canzone casuale; impostalo per riprodurne una. |
bpm | No | — | Omettilo per lasciar scegliere al modello. |
keyScale | No | — | Ad esempio Do maggiore o La minore. Omettila per lasciar scegliere al modello. |
timeSignature | No | — | Battiti per battuta, ad es. 4 per 4/4 o 3 per 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}Fai polling con la stessa chiave API finché status non è terminale (COMPLETED, FAILED, CANCELED o MODERATION_BLOCKED). Quando la moderazione dei contenuti è abilitata, i job possono iniziare in MODERATION_PENDING prima di entrare nella coda di calcolo. I job completati includono valori download_url presigned su ogni output.
Risposta di creazione
{
"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"
}Risposta di completamento
{
"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>"
}Descrivi uno stile, aggiungi un testo facoltativo e scarica una canzone con voce cantata, fino a circa quattro minuti di audio stereo. Da testo a musica gratis sui dispositivi che colleghi. La prima esecuzione scarica il modello; le canzoni successive partono più velocemente.