Audio
Generador de música ACE-Step
Describa un estilo, añada una letra y descargue una canción con voz. Texto a música gratis en los dispositivos que conecte.
ACE-Step by ACE Studio and StepFun; Qwen3 Embedding by Alibaba Cloud
Licencias del 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.
Referencia de la API
Enviar mediante REST
Use su clave de API personal (msk_…) para crear trabajos de esta carga de trabajo desde sus propias herramientas. Los trabajos iniciados así se ejecutan en los mismos dispositivos que conectó en Sus dispositivos: al menos uno tiene que estar en línea.
https://cp.meshlabs.cloud/v1/organizations/jobsAutentíquese con X-Organization-Api-Key: msk_your_personal_api_key. El nombre del encabezado coincide con el de las claves de organización; las claves personales usan el mismo endpoint.
Cuerpo de la solicitud
{
"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 | Obligatorio | Predeterminado | Descripción |
|---|---|---|---|
prompt | Sí | — | Género, instrumentación, ambiente, carácter de la voz. |
lyrics | No | — | Opcional. Admite etiquetas de estructura [verse] / [chorus] / [bridge]. Déjelo vacío para una pieza instrumental. |
vocalLanguage | No | en | Código de idioma de la letra, p. ej. en, zh, ja, es. Se ignora en una pieza instrumental. |
durationSec | No | 60 | Duración de la canción. Si el trabajo omite el campo, se ejecutan 60 segundos. |
shift | No | 3 | Programa de pasos de tiempo. 3 favorece la fidelidad y 1 favorece el ajuste al prompt. |
seed | No | — | Omítala para una canción aleatoria; indíquela para reproducir una. |
bpm | No | — | Omítalo para que el modelo elija. |
keyScale | No | — | Por ejemplo, do mayor o la menor. Omítala para que el modelo elija. |
timeSignature | No | — | Pulsos por compás, p. ej. 4 para 4/4 o 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 periódicamente con la misma clave de API hasta que status sea final (COMPLETED, FAILED, CANCELED o MODERATION_BLOCKED). Cuando la moderación de contenido está habilitada, los trabajos pueden empezar en MODERATION_PENDING antes de entrar en la cola de cómputo. Los trabajos completados incluyen valores download_url prefirmados en cada salida.
Respuesta de creación
{
"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"
}Respuesta de trabajo completado
{
"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>"
}Describa un estilo, añada una letra opcional y descargue una canción con voz cantada: hasta unos cuatro minutos de audio estéreo. Texto a música gratis en los dispositivos que conecte. La primera ejecución descarga el modelo; las siguientes canciones empiezan más rápido.