Audio
ACE-Step Music Generator
Deskripsikan gaya musik, tambahkan lirik, dan unduh lagu lengkap dengan vokal. Teks ke musik gratis di perangkat yang Anda hubungkan.
ACE-Step by ACE Studio and StepFun; Qwen3 Embedding by Alibaba Cloud
Lisensi model
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.
Referensi API
Kirim melalui REST
Gunakan kunci API pribadi Anda (msk_…) untuk membuat tugas bagi beban kerja ini dari alat Anda sendiri. Tugas yang dimulai dengan cara ini berjalan di perangkat yang sama yang Anda hubungkan di Perangkat Anda — setidaknya satu harus online.
https://cp.meshlabs.cloud/v1/organizations/jobsAutentikasi dengan X-Organization-Api-Key: msk_your_personal_api_key. Nama header sama dengan kunci organisasi; kunci pribadi menggunakan endpoint yang sama.
Isi permintaan
{
"workload_type": "ace-step-15-turbo-music",
"job_spec": {
"prompt": "A photorealistic lighthouse at dusk",
"vocalLanguage": "en",
"durationSec": 60,
"shift": 3
}
}Kolom job_spec
| Kolom | Wajib | Default | Deskripsi |
|---|---|---|---|
prompt | Ya | — | Genre, instrumentasi, suasana, karakter vokal. |
lyrics | Tidak | — | Opsional. Mendukung tag struktur [verse] / [chorus] / [bridge]. Kosongkan untuk lagu instrumental. |
vocalLanguage | Tidak | en | Kode bahasa untuk lirik, mis. en, zh, ja, es. Diabaikan untuk lagu instrumental. |
durationSec | Tidak | 60 | Panjang lagu. Jika kolom ini dikosongkan, tugas berjalan dengan 60 detik. |
shift | Tidak | 3 | Jadwal timestep. Nilai 3 mengutamakan fidelitas, nilai 1 mengutamakan kesesuaian dengan prompt. |
seed | Tidak | — | Kosongkan untuk lagu acak; isi untuk mereproduksi lagu yang sama. |
bpm | Tidak | — | Kosongkan agar model yang memilih. |
keyScale | Tidak | — | Misalnya C major atau A minor. Kosongkan agar model yang memilih. |
timeSignature | Tidak | — | Jumlah ketukan per birama, mis. 4 untuk 4/4 atau 3 untuk 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}Lakukan polling dengan kunci API yang sama sampai status mencapai status akhir (COMPLETED, FAILED, CANCELED, atau MODERATION_BLOCKED). Jika moderasi konten diaktifkan, tugas dapat dimulai dalam status MODERATION_PENDING sebelum masuk ke antrean komputasi. Tugas yang selesai menyertakan nilai download_url presigned pada setiap keluaran.
Respons pembuatan
{
"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"
}Respons selesai
{
"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>"
}Deskripsikan gaya musik, tambahkan lirik opsional, dan unduh lagu dengan vokal yang dinyanyikan — audio stereo hingga sekitar empat menit. Teks ke musik gratis di perangkat yang Anda hubungkan. Saat pertama dijalankan, model diunduh; lagu berikutnya dimulai lebih cepat.