Âm thanh
Trình tạo nhạc ACE-Step
Mô tả phong cách, thêm lời bài hát và tải về một bài hát có giọng hát. Chuyển văn bản thành nhạc miễn phí trên các thiết bị bạn kết nối.
ACE-Step by ACE Studio and StepFun; Qwen3 Embedding by Alibaba Cloud
Giấy phép mô hình
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.
Tài liệu tham khảo API
Gửi qua REST
Dùng khóa API cá nhân của bạn (msk_…) để tạo tác vụ cho workload này từ công cụ của riêng bạn. Tác vụ khởi chạy theo cách này chạy trên chính các thiết bị bạn đã kết nối tại Thiết bị của bạn — ít nhất một thiết bị phải trực tuyến.
https://cp.meshlabs.cloud/v1/organizations/jobsXác thực bằng X-Organization-Api-Key: msk_your_personal_api_key. Tên header giống với khóa tổ chức; khóa cá nhân dùng cùng endpoint.
Nội dung yêu cầu
{
"workload_type": "ace-step-15-turbo-music",
"job_spec": {
"prompt": "A photorealistic lighthouse at dusk",
"vocalLanguage": "en",
"durationSec": 60,
"shift": 3
}
}Các trường của job_spec
| Trường | Bắt buộc | Mặc định | Mô tả |
|---|---|---|---|
prompt | Có | — | Thể loại, nhạc cụ, tâm trạng, đặc điểm giọng hát. |
lyrics | Không | — | Không bắt buộc. Hỗ trợ các thẻ cấu trúc [verse] / [chorus] / [bridge]. Để trống nếu muốn nhạc không lời. |
vocalLanguage | Không | en | Mã ngôn ngữ của lời bài hát, ví dụ en, zh, ja, es. Bị bỏ qua đối với nhạc không lời. |
durationSec | Không | 60 | Độ dài của bài hát. Nếu tác vụ không khai báo trường này, mặc định chạy 60 giây. |
shift | Không | 3 | Lịch trình bước thời gian. Giá trị 3 ưu tiên độ trung thực, giá trị 1 ưu tiên bám sát mô tả. |
seed | Không | — | Bỏ trống để có bài hát ngẫu nhiên; đặt giá trị để tái tạo lại đúng bài đó. |
bpm | Không | — | Bỏ trống để mô hình tự chọn. |
keyScale | Không | — | Ví dụ: Đô trưởng (C major) hoặc La thứ (A minor). Bỏ trống để mô hình tự chọn. |
timeSignature | Không | — | Số phách mỗi ô nhịp, ví dụ 4 cho nhịp 4/4 hoặc 3 cho nhịp 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}Thăm dò bằng cùng khóa API cho đến khi status ở trạng thái kết thúc (COMPLETED, FAILED, CANCELED hoặc MODERATION_BLOCKED). Khi kiểm duyệt nội dung được bật, tác vụ có thể bắt đầu ở MODERATION_PENDING trước khi vào hàng đợi tính toán. Tác vụ đã hoàn tất có các giá trị download_url được ký trước trên mỗi đầu ra.
Phản hồi khi tạ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"
}Phản hồi khi hoàn tất
{
"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>"
}Mô tả phong cách, thêm lời bài hát (không bắt buộc) và tải về một bài hát có giọng hát — âm thanh stereo dài tới khoảng bốn phút. Chuyển văn bản thành nhạc miễn phí trên các thiết bị bạn kết nối. Lần chạy đầu tiên sẽ tải mô hình về; các bài hát sau sẽ bắt đầu nhanh hơn.