Â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.

Giấy phép đi kèm

Thông báo

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.

Miễn phíTrực tuyếnKhông giới hạnACE-Step by ACE Studio and StepFun; Qwen3 Embedding by Alibaba Cloud Truy cập API

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.

Ẩn chi tiết API
POSThttps://cp.meshlabs.cloud/v1/organizations/jobs

Xá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ườngBắt buộcMặc địnhMô tả
promptCó—Thể loại, nhạc cụ, tâm trạng, đặc điểm giọng hát.
lyricsKhô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.
vocalLanguageKhôngenMã 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.
durationSecKhông60Độ 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.
shiftKhông3Lị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ả.
seedKhô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 đó.
bpmKhông—Bỏ trống để mô hình tự chọn.
keyScaleKhông—Ví dụ: Đô trưởng (C major) hoặc La thứ (A minor). Bỏ trống để mô hình tự chọn.
timeSignatureKhô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
  }
}'
GEThttps://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.