Cách tạo bài hát AI bằng ACE Music API

22 phút đọc • 14 tháng 11 năm 2026

Mục lục

  1. Giới thiệu
  2. Các model và những gì API làm được
  3. Giá
  4. Cách tạo bài hát bằng curl
    1. Thêm tài khoản ACE Music của bạn
    2. Tạo bài hát từ prompt
    3. Kết quả trả về
    4. Đồng bộ, bất đồng bộ và webhook
  5. Hát lời của riêng bạn
  6. Điều chỉnh nhịp độ, tông và số chỉ nhịp với ACE-Step
  7. Cover, remix và chỉnh sửa
    1. Mashup hai hoặc ba bài hát
  8. Định hướng bài hát bằng âm thanh và hình ảnh của bạn
  9. Stem, tải về và bản nhạc
    1. Tách bài hát thành stem
    2. Tải MP3, WAV, MIDI và MusicXML
    3. Đọc bản nhạc
  10. Thư viện của bạn
  11. Nhiều tài khoản ACE Music
  12. Dùng từ Claude, ChatGPT hoặc Cursor (MCP)
  13. Tạo hàng loạt bằng script
  14. Ví dụ
    1. Bài hát từ một bức ảnh
    2. Bài hát từ prompt
    3. Lời của riêng bạn
    4. ACE-Step với nhịp độ, tông và số chỉ nhịp cố định
    5. Một bản cover, một bản remix và một bản chỉnh sửa
    6. Mashup
    7. Âm thanh và hình ảnh của bạn
    8. Các stem của “Paper Lanterns”
  15. Câu hỏi thường gặp
  16. Kết luận

Giới thiệu

ACE Music API của useapi.net biến một lệnh gọi REST thành hai bài hát hoàn chỉnh từ ACE Music, có giọng hát, lời, tên bài và ảnh bìa, trên chính gói ACE Music bạn đang dùng. ACE Music v1 đứng hạng 1 trên bảng xếp hạng nhạc có giọng hát của Artificial Analysis, trên cả Suno v6, và ACE Music v1 lẫn v1.1 đều không có API công khai riêng (tính đến tháng 11/2026), nên useapi.net là cách duy nhất để gọi chúng từ code. Model mã nguồn mở ACE-Step v1.5 XL chạy qua cùng API này mà không tốn credit trên bất kỳ gói ACE Music nào, kể cả gói Free.

Hướng dẫn này bắt đầu với ba model và chi phí của một bài hát, tạo trọn vẹn một bài hát bằng curl, rồi điểm qua mọi tính năng còn lại trong một bảng ngắn. Phần Ví dụ ở cuối gồm 18 bài hát chúng tôi tạo cho trang này, mỗi bài kèm request đã tạo ra nó, tất cả từ các script trong repo GitHub acemusic-api (Node.js và Python), tốn 117 credit của một gói Artist, tính cả những lần chạy thêm. useapi.net là API của bên thứ ba, không liên kết với ACE Music hay Timedomain, công ty tạo ra ACE Music.

Các model và những gì API làm được

Mỗi request tạo hai bài hát, và model chọn model sẽ tạo chúng:

Model model Dùng để làm gì Thiết lập Credit mỗi request Thời gian chạy thử
ACE Music v1 acemusic-v1 (mặc định) Model giọng hát hạng 1: bài hát từ prompt hoặc từ lời của bạn, có hát hoặc không lời duration 30 đến 600 giây, negative, styleInfluence, tải WAV 4 46 đến 89 giây
ACE Music v1.1 Preview acemusic-v1.1 Viết bản nhạc (score) trước, nên các bản cover và mashup bám theo giai điệu của bài gốc audioInfluence, styleInfluence 4 35 đến 83 giây
ACE-Step v1.5 XL ace-step-1.5-xl Mã nguồn mở của ACE Studio và StepFun: bài hát, remix và chỉnh sửa bpm, key, timeSignature, duration 10 đến 240 giây, negative, thinking. Chỉ MP3 0 20 đến 55 giây

Những gì bạn làm được với chúng:

Tính năng Request Ghi chú
Bài hát từ prompt POST /music prompt ACE Music tự viết phong cách, lời và tên bài
Lời của riêng bạn, nhạc không lời POST /music style, lyrics Mọi ngôn ngữ
Công cụ viết lời và viết phong cách POST /music/lyrics, /music/style Không tốn credit
Cover, remix, chỉnh sửa, mashup POST /music mode Trên bất kỳ bài hát nào của tài khoản
Âm thanh và hình ảnh của bạn POST /files Làm tham chiếu cho bài hát mới
Stem POST /music/stems Creator và Artist
Tải về, bản nhạc GET /music/download, /music/score MP3 và bản nhạc trên mọi gói, WAV, MIDI và MusicXML trên Creator và Artist
Thư viện, job, tài khoản GET /music, /jobs, /accounts Mọi bài hát của tài khoản, các job đang chạy, số credit theo thời gian thực
MCP server /v1/acemusic/mcp 15 công cụ cho trợ lý AI

Giá

ACE Music tính credit của riêng mình cho mỗi request, trừ vào gói ACE Music của bạn, và useapi.net không thu thêm gì theo bài hát (tính đến tháng 11/2026):

Request Credit
Hai bài hát trên ACE Music v1 hoặc v1.1 4
Stem, giọng hát + nhạc nền 5, gói trả phí
Stem, mọi stem 60, gói trả phí
Bản nhạc của một bài ACE-Step, lần đọc đầu tiên 1
Hai bài hát trên ACE-Step v1.5 XL 0, trên mọi gói
Công cụ viết lời và phong cách, upload, tải về 0 trong các lần thử của chúng tôi

Các gói ACE Music gồm Free với 20 credit mỗi ngày, Creator $9,90 một tháng cho 1.000 credit và Artist $29 một tháng cho 2.500 credit, hoặc $7,90 và $16,58 một tháng khi trả theo năm. Một bài hát là nửa request, tức 2 credit. Trang tổng quan API có cùng bảng này.

Chi phí một bài hát trên từng gói, rẻ nhất ở bên trái (một request tạo hai bài hát, nên một bài tốn nửa số credit của request, tính đến tháng 11/2026):

Model Free
20 cr/ngày		 Artist $16,58/th
2.500 cr/tháng, trả theo năm		 Creator $7,90/th
1.000 cr/tháng, trả theo năm		 Creator $9,90/th
1.000 cr/tháng		 Artist $29/th
2.500 cr/tháng
ACE Music v1, v1.1
một bài		 $0 / 2 cr
10 bài/ngày		 $0,013 / 2 cr
1.250 bài/tháng		 $0,016 / 2 cr
500 bài/tháng		 $0,020 / 2 cr
500 bài/tháng		 $0,023 / 2 cr
1.250 bài/tháng
Stem
giọng hát + nhạc nền		 gói trả phí $0,033 / 5 cr $0,040 / 5 cr $0,050 / 5 cr $0,058 / 5 cr
Stem
mọi stem		 gói trả phí $0,40 / 60 cr $0,47 / 60 cr $0,59 / 60 cr $0,70 / 60 cr
Bản nhạc ACE-Step
lần đọc đầu		 $0 / 1 cr $0,007 / 1 cr $0,008 / 1 cr $0,010 / 1 cr $0,012 / 1 cr
ACE-Step v1.5 XL
một bài		 $0 / 0 cr $0 / 0 cr $0 / 0 cr $0 / 0 cr $0 / 0 cr

So với các cách khác để gọi những model này từ code:

Model useapi.net Các API khác
ACE Music v1, v1.1 Preview từ $0,013 một bài trên Artist trả theo năm, $0 với 20 credit mỗi ngày của gói Free không có: ACE Music không cung cấp API công khai cho các model này
ACE-Step v1.5 XL $0 trên mọi gói ACE Music, kể cả gói Free khoảng $0,14 một bài trên API của bên thứ ba acestep.io, vốn đòi gói Studio $49 một tháng

Trên mọi gói ACE Music, kể cả gói Free, một bài hát ACE-Step v1.5 XL không tốn credit nào, trong khi API của acestep.io (bên thứ ba) đòi gói Studio $49 một tháng (khoảng 360 bài mỗi tháng, khoảng $0,14 một bài, tính đến tháng 11/2026).

Bắt đầu dùng API

Một gói đăng ký $15/tháng dùng được mọi API trên useapi.net: một token cho tất cả dịch vụ. Mỗi dịch vụ bạn kết nối tối đa 3 tài khoản của riêng mình, còn useapi.net lo REST API, cân bằng tải và polling. Cần thêm tài khoản? Mỗi gói đăng ký thêm giá $10/tháng và cho thêm 3 tài khoản ở mỗi dịch vụ.

Đăng ký — $15/tháng Thanh toán bằng tiền mã hóa

Không có thẻ thanh toán quốc tế? Bạn có thể đăng ký bằng tiền mã hóa (thanh toán bằng tiền mã hóa không được hoàn tiền). Giá và các gói số lượng lớn có trên trang đăng ký. Nếu thanh toán qua Stripe, bạn được hoàn tiền toàn bộ trong 14 ngày kể từ lần mua đầu tiên khi có dưới 50 lượt tạo thành công. Đã đăng ký rồi? Hãy đổi số lượng trong Stripe Customer Portal thay vì mua lại.

Cách tạo bài hát bằng curl

Bạn cần một API token của useapi.net, xem Setup useapi.net, và một tài khoản ACE Music có email và mật khẩu. Một gói đăng ký $15 một tháng bao gồm mọi API của useapi.net và 3 tài khoản ACE Music. Tài khoản ACE Music Free cũng dùng được: nó có 20 credit mỗi ngày, và bài hát ACE-Step không tốn credit nào. Các lệnh dùng jq để đọc JSON.

Thêm tài khoản ACE Music của bạn

Export token, rồi thêm tài khoản một lần. API sẽ đăng nhập, đọc thông tin tài khoản và chỉ lưu lại nếu ACE Music chấp nhận mật khẩu:

export USEAPI_TOKEN="user:12345-..."
API=https://api.useapi.net/v1/acemusic

curl -s -X POST "$API/accounts" \
  -H "Authorization: Bearer $USEAPI_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "email": "[email protected]", "password": "your-acemusic-password" }'

Tài khoản tạo bằng Continue with Google hoặc số điện thoại cần đặt mật khẩu trước, xem Setup ACE Music, trang này cũng có thể thêm tài khoản giúp bạn.

Tạo bài hát từ prompt

Mô tả bài hát bằng lời của bạn. ACE Music viết phong cách, lời và tên bài, rồi tạo hai bài hát. Đây chính là request đã tạo ra bài hát đầu tiên trên trang này:

curl -s -X POST "$API/music" \
  -H "Authorization: Bearer $USEAPI_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A late-night neo-soul slow jam about two strangers sharing an umbrella at a bus stop in the rain and missing the last bus on purpose. Warm Rhodes piano, brushed drums, round upright bass, a smoky female lead with close three-part harmonies on the chorus.",
    "model": "acemusic-v1",
    "async": true
  }' | tee job.json | jq '{jobid, status, model}'

Với async: true, API trả 201 ngay lập tức kèm job. Một prompt dài tối đa 2.000 ký tự và nhận tối đa 3 bài hát tham chiếu cùng 3 hình ảnh, xem Định hướng bài hát bằng âm thanh và hình ảnh của bạn.

Kết quả trả về

Trong lúc ACE Music viết lời, các bài hát ở trạng thái planning và mang tên Untitled, sau đó chuyển sang queued và running. Poll GET /jobs/jobid khoảng 10 giây một lần. jobid chứa : và @, nên hãy URL-encode nó:

curl -s "$API/jobs/$(jq -r .jobid job.json | jq -Rr @uri)" \
  -H "Authorization: Bearer $USEAPI_TOKEN" | jq '{status, songs: [.songs[] | {title, status, duration, audioUrl}]}'

Khi status là completed, mỗi bài hát mang theo các link của nó (các id dưới đây là bịa ra):

{
  "jobid": "j1115003713275918262m-u12345-email:[email protected]:so_7c1d9e3a5b2f4806a4e1c9d3.so_8b4f2e6a1c9d47e5a3b7c0d2-bot:acemusic",
  "type": "music",
  "status": "completed",
  "email": "[email protected]",
  "created": "2026-11-15T00:37:13.275Z",
  "model": "acemusic-v1",
  "modelUsed": "acemusic-v1",
  "songs": [
    {
      "songId": "user:[email protected]:so_7c1d9e3a5b2f4806a4e1c9d3",
      "taskId": "so_7c1d9e3a5b2f4806a4e1c9d3",
      "status": "succeeded",
      "title": "Let the 44 Roll By",
      "model": "acemusic-v1",
      "style": "Late-night neo-soul slow jam with a laid-back 1990s and early 2000s pocket, 72 BPM. …",
      "lyrics": "[Intro - Warm Rhodes chords, brushed snare rim clicks, subtle rain on asphalt]\n\n[Verse 1 …]\nWater dripping off the canvas seam\n…",
      "instrumental": false,
      "duration": 277.19,
      "audioUrl": "https://acemusic.ai/data/so_7c1d9e3a5b2f4806a4e1c9d3.mp3",
      "playUrl": "https://….r2.cloudflarestorage.com/acemusic-data-prod/users/…/audio/202611/….mp3?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20261115T003902Z&X-Amz-Expires=3599&…",
      "playUrlExpires": "2026-11-15T01:39:01.000Z",
      "coverUrl": "https://acemusic.ai/data/so_7c1d9e3a5b2f4806a4e1c9d3-cover.jpg?v=1794703081642",
      "pageUrl": "https://acemusic.ai/song/r4k8w2n6p9tz",
      "created": "2026-11-15T00:37:13.300Z",
      "finished": "2026-11-15T00:38:42.208Z",
      "kind": "original",
      "score": false
    },
    { "songId": "user:[email protected]:so_8b4f2e6a1c9d47e5a3b7c0d2", "title": "Let the 44 Roll By", "duration": 253.99, "…": "…" }
  ],
  "completed": "2026-11-15T00:38:42.208Z"
}
  • audioUrl là link MP3 công khai của bài hát và không bao giờ thay đổi. playUrl là link trực tiếp tới cùng file MP3 đó dành cho trình phát trên web, có hiệu lực đến playUrlExpires (khoảng một giờ): một số trình duyệt, như Brave, chặn lần chuyển hướng phía sau audioUrl.
  • songId là thứ mà cover, mashup, stem, tải về và bản nhạc nhận vào. Nó chỉ rõ tài khoản chứa bài hát, nên các lệnh gọi đó chạy trên tài khoản ấy.
  • model là model bạn yêu cầu, modelUsed là model thực sự đã chạy (xem mashup). kind là original, cover, edit, mashup hoặc upload, và score cho biết bài hát đã có bản nhạc hay chưa.
  • Bài hát mà ACE Music không tạo được sẽ có status: "failed", lý do của ACE Music trong error, và refunded: true khi credit đã được hoàn lại.

Và đây là bài đầu tiên trong hai bài hát đó:

ACE Music v1 — “Let the 44 Roll By” · 4:37 · tạo trong 89 giây

Đồng bộ, bất đồng bộ và webhook

Bạn gửi Lệnh POST trả về Sau đó
async: true 201 ngay lập tức, kèm job Poll GET /jobs/jobid
không có async 200 kèm job đã xong, cùng JSON như trên Đọc các bài hát từ phản hồi. Request vẫn chạy sau 100 giây sẽ trả 202 kèm job: hãy poll nó
replyUrl và replyRef như trên, cho cả đồng bộ lẫn bất đồng bộ URL https công khai của bạn nhận một lệnh POST chứa job đã xong, kèm replyRef của bạn

Request ACE-Step không có async của chúng tôi trả về sau 37 giây, và webhook đến 12 giây sau khi các bài hát xong. Một job đọc được trong 7 ngày, và job vẫn chạy sau 30 phút kể từ lúc bắt đầu sẽ thất bại với 504. async-webhooks/ chạy cả ba cách và có kèm một bộ nhận webhook nhỏ.

Xem lệnh gọi API 
curl -s -X POST "$API/music" \
  -H "Authorization: Bearer $USEAPI_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A dreamy lo-fi hip hop beat for studying late at night: dusty vinyl crackle, mellow Rhodes chords, a soft upright bass and rain on the window",
    "model": "ace-step-1.5-xl",
    "replyUrl": "https://your-server.example.com/acemusic-hook",
    "replyRef": "lofi-1"
  }' | jq '{status, songs: [.songs[] | {title, duration, audioUrl}]}'

Hát lời của riêng bạn

Gửi style và lyrics thay cho prompt, và ACE Music sẽ hát lời của bạn theo phong cách của bạn:

Trường Tác dụng Giới hạn
style Thể loại, nhạc cụ, cảm xúc, nhịp độ và giọng hát 1.000 ký tự, 512 trên ACE-Step
lyrics Lời của bạn, mọi ngôn ngữ, với các tag [Verse], [Chorus], [Bridge] 5.000 ký tự, 2.000 trên ACE-Step
title Tên của các bài hát. Nếu không có, ACE Music tự chọn 80 ký tự
instrumental true để không có giọng hát. Một style không kèm lyrics cũng cho kết quả như vậy  
duration Độ dài tính bằng giây 30 đến 600 trên ACE Music v1, 10 đến 240 trên ACE-Step
negative Những phong cách cần tránh 200 ký tự, ACE Music v1 và ACE-Step
styleInfluence Mức độ bám sát phong cách 0 đến 100, mặc định 80, ACE Music v1 và v1.1

Đừng bao giờ gửi prompt cùng với các trường này: API sẽ trả 400 và nêu rõ trường cần bỏ. Bản ballad của chúng tôi yêu cầu duration: 210 và nhận về hai bài dài 210 và 209 giây. Bài đó nằm trong phần Ví dụ, cùng một bản không lời và một bài hát tiếng Tây Ban Nha.

Chưa có lời? POST /music/lyrics viết lời và tên bài từ một yêu cầu, còn POST /music/style biến vài từ thành một phong cách đầy đủ. Hai lệnh của chúng tôi trả về sau 6 và 4 giây, không tốn credit. Script: custom-lyrics/.

Điều chỉnh nhịp độ, tông và số chỉ nhịp với ACE-Step

ACE-Step v1.5 XL nhận những thiết lập âm nhạc mà các model ACE Music không có, và bài hát của nó không tốn credit:

Tùy chọn Giá trị
bpm 30 đến 200
timeSignature 2/4, 3/4, 4/4, 6/8
key C major đến B minor (C, C#, D, Eb, E, F, F#, G, Ab, A, Bb, B)
duration 10 đến 240 giây
negative những phong cách cần tránh, tối đa 200 ký tự
thinking 0 đến 100: ACE-Step lên kế hoạch cho cả bài trước, sáng tạo khi thấp, ổn định khi cao

Cả ba bài ACE-Step của chúng tôi, một điệu valse 3/4, một điệu jig 6/8 và một bài drum and bass 174 bpm, đều có độ dài đúng như yêu cầu (Ví dụ). Các tùy chọn này chỉ hoạt động ở mode generate trên ace-step-1.5-xl, và ở bất kỳ chỗ nào khác API sẽ trả 400 Parameter bpm does not apply to mode generate on acemusic-v1. Script: ace-step-options/.

Cover, remix và chỉnh sửa

mode biến một request thành thao tác trên những bài hát bạn đã có. references nhận songId của chúng: bài hát do API tạo, bài hát trong Thư viện của bạn hoặc file bạn tự upload.

mode references Chạy trên Credit Tác dụng
cover 1 bài acemusic-v1.1, hoặc ACE-Step trên ace-step-1.5-xl 4 / 0 Bài hát với style mới, bám theo giai điệu, hợp âm và cấu trúc của nó
remix 1 bài ace-step-1.5-xl 0 coverStrength giữ lại bản gốc, remixStrength đưa bài hát xa khỏi bản gốc (0 đến 100)
edit 1 bài ace-step-1.5-xl 0 Viết lại đoạn giữa giây start và end bằng lyrics mới, giữ nguyên phần còn lại
mashup 2 hoặc 3 bài acemusic-v1.1 4 Một bài hát mới từ nhiều bài, xem bên dưới

ACE Music v1.1 bám theo giai điệu mà nó đọc từ bản nhạc của bài hát. Bản cover đầu tiên của chúng tôi cho một bài ACE Music v1 chưa có bản nhạc đã thất bại với ref_no_melody, và 4 credit được hoàn lại, nên giờ đây API tự đọc bản nhạc của bài ACE Music v1 trước, miễn phí, rồi mới làm cover hoặc mashup v1.1. Bài hát ACE-Step không được đọc tự động: nếu một bài trả 400 với ref_no_melody, hãy gọi GET /music/score cho bài đó trước (1 credit), rồi gửi lại request. Script: covers-remix-edit/.

Mashup hai hoặc ba bài hát

mode: "mashup" tạo một bài hát từ 2 hoặc 3 bài trên cùng một tài khoản, kết hợp lời của chúng trừ khi bạn gửi lyrics. audioInfluence (0 đến 100, mặc định 60) quyết định mức độ bám theo các bài gốc. Mashup phải đọc các bài hát, nên nó chạy trên ACE Music v1.1 Preview ngay cả khi bạn yêu cầu v1, giống như trên website ACE Music: bài “Harbor Fiesta” của chúng tôi báo "model": "acemusic-v1" và "modelUsed": "acemusic-v1.1", và credit tính theo model đã thực sự chạy. Điều tương tự xảy ra với cover yêu cầu trên v1, với prompt có nhiều hơn một tham chiếu trên ACE-Step, và đôi khi với prompt có một bài hát tham chiếu. Script: mashup/.

Định hướng bài hát bằng âm thanh và hình ảnh của bạn

POST /files nhận file làm phần thân request thô, kèm Content-Type của file:

Upload Định dạng Tối đa Bạn nhận được Dùng làm
Âm thanh MP3, WAV, FLAC, OGG, M4A, AAC 100 MB, 8 phút Một songId: một bài hát trong Thư viện, với lời, phong cách, nhịp độ và giai điệu do ACE Music chép lại Một trong tối đa 3 references của prompt, hoặc bài hát để cover, remix, chỉnh sửa hay mashup
Hình ảnh JPEG, PNG, WebP 10 MB Một mediaId Một trong tối đa 3 images của prompt: ACE Music viết một bài hát về hình ảnh đó 
curl -s -X POST "$API/files?title=Harbour%20Jig%20demo" \
  -H "Authorization: Bearer $USEAPI_TOKEN" \
  -H "Content-Type: audio/mpeg" \
  --data-binary @harbour-jig-demo.mp3 | jq '{songId, status, duration, bpm: .upload.bpm}'

Bản upload “Harbour Jig” dài 90 giây của chúng tôi được chép lại trong 14 giây, và ACE Music nghe ra 115 bpm (chúng tôi đã yêu cầu 116). Một bức ảnh robot đang nhảy đã trở thành bài drum and bass về bộ lông xanh mòng két và đôi giày cổ cao màu cam của nó. Cả hai đều có trong phần Ví dụ. File upload được tính vào hạn mức của tài khoản: 10 phút âm thanh trên Free, 30 trên Creator và 60 trên Artist. Script: upload-reference/.

Stem, tải về và bản nhạc

Mọi bài hát đã xong đều có thể được tách, tải về và đọc thành bản nhạc:

Request Gói Credit Bạn nhận được
Stem, mode: "vocals" Creator, Artist 5 Các file MP3 vocal và instrumental
Stem, mode: "all" Creator, Artist 60 Mọi stem ACE Music tìm thấy, dưới dạng MP3
Tải về mp3 (mặc định) mọi gói 0 url (giống audioUrl) và playUrl
Tải về wav Creator, Artist 0 Một link có hiệu lực 24 giờ. Không dành cho bài ACE-Step
Tải về midi, musicxml Creator, Artist 0 Chính file đó
Bản nhạc mọi gói 0, 1 cho bài ACE-Step ở lần đầu Ký hiệu ABC: giai điệu giọng hát, một bè nhạc cụ, hợp âm và các đoạn

Tách bài hát thành stem

Lần tách giọng hát của “Paper Lanterns” mất khoảng 80 giây, và lần tách đầy đủ chưa tới 2 phút, ra 9 stem: giọng chính, bè phụ, trống, bass, guitar, keyboard, dây, synth và hiệu ứng (nghe thử). Link stem có hiệu lực 24 giờ, nên hãy đọc lại bài hát để lấy link mới. Tách lại một bài ở cùng chế độ sẽ trả kết quả ngay và không tốn gì.

Tải MP3, WAV, MIDI và MusicXML

ACE Music tạo WAV, MIDI và MusicXML ở request đầu tiên: API chờ tối đa một phút, rồi trả 202, nên hãy gọi lại sau một phút. Với “Paper Lanterns”, cả ba sẵn sàng chỉ trong vài giây: một file WAV 40 MB, một file MIDI 8 KB và một bản nhạc MusicXML 107 KB.

Xem lệnh gọi API 
SONG="user:[email protected]:so_4e7b2c9d0a5f4183b6d8e2c7"

curl -s -G "$API/music/download" --data-urlencode "songId=$SONG" -d format=wav \
  -H "Authorization: Bearer $USEAPI_TOKEN" | jq '{url, expires}'

curl -s -G "$API/music/download" --data-urlencode "songId=$SONG" -d format=midi \
  -H "Authorization: Bearer $USEAPI_TOKEN" -o paper-lanterns.mid

Đọc bản nhạc

Bất kỳ công cụ ABC nào cũng chuyển bản nhạc thành bản nhạc in (sheet music). Với “Paper Lanterns”, nó ghi 72 bpm, đúng nhịp độ chúng tôi yêu cầu trong phong cách. Bài hát ACE Music v1.1 có sẵn bản nhạc, và các bản cover và mashup v1.1 bám theo nó, xem Cover, remix và chỉnh sửa.

Xem lệnh gọi API 
SONG="user:[email protected]:so_4e7b2c9d0a5f4183b6d8e2c7"

curl -s -G "$API/music/score" --data-urlencode "songId=$SONG" \
  -H "Authorization: Bearer $USEAPI_TOKEN" | jq -r .abc | head -14

X:1
T:
M:2/4
L:1/16
Q:1/4=72
V: Vocal clef=treble name="Vocal Melody" snm="Vocal"
V: Ins clef=treble name="Ins Melody" snm="Inst."
K:Ab
% intro
V: Vocal
Z|"Ab"z8|"Ab"z8|"Ab"z8|
V: Ins
Z|Ac2AcBA2|A2EAA2EA|Ac2AcBA2|

Script: stems-and-downloads/, lưu các stem, mọi định dạng tải về và bản nhạc.

Thư viện của bạn

Mọi bài hát và file upload của tài khoản, dù tạo ở đây hay trên acemusic.ai, đều nằm trong Thư viện cho đến khi bị xóa:

Request Tác dụng
GET /music Một trang bài hát, mới nhất trước, kèm next cho trang tiếp theo. Cần email khi có nhiều hơn một tài khoản. Bài hát của các job cũ hơn 7 ngày nằm ở đây
GET /music/songId Một bài hát với link mới, và các stem của nó nếu đã được tách
DELETE /music/songId 204: bài hát chuyển vào thùng rác của tài khoản trên acemusic.ai, và từ đó API trả 404 cho bài này
Xem lệnh gọi API 
SONG="user:[email protected]:so_4e7b2c9d0a5f4183b6d8e2c7"

curl -s -G "$API/music" --data-urlencode "[email protected]" -d limit=20 \
  -H "Authorization: Bearer $USEAPI_TOKEN" | jq '{next, songs: [.songs[] | {title, model, kind, songId}]}'

curl -s "$API/music/$(jq -rn --arg v "$SONG" '$v|@uri')" \
  -H "Authorization: Bearer $USEAPI_TOKEN" | jq '{title, score, audioUrl, playUrl, stems: (.stems // {} | keys)}'

curl -s -o /dev/null -w "%{http_code}\n" -X DELETE "$API/music/$(jq -rn --arg v "$SONG" '$v|@uri')" \
  -H "Authorization: Bearer $USEAPI_TOKEN"

Script: library/.

Nhiều tài khoản ACE Music

Mỗi gói đăng ký useapi.net kết nối 3 tài khoản ACE Music, tổng cộng tối đa 100. Request không có email sẽ đi tới một tài khoản đang hoạt động tốt và còn chỗ trống, còn request nhắc tới một bài hát, một file upload hay một hình ảnh sẽ chạy trên tài khoản chứa nó. Mỗi tài khoản chạy đồng thời tối đa maxJobs request, mặc định là 4, đúng giới hạn của chính ACE Music. Khi mọi tài khoản đều bận, API trả 429 kèm Retry-After, và nếu ACE Music từ chối mật khẩu thì tài khoản đó sẽ trả 596 cho đến khi bạn thêm lại nó.

GET /accounts/email đọc gói, số credit và giá credit theo thời gian thực, còn POST /accounts chỉ với email và maxJobs thì chỉ thay đổi maxJobs. Script: accounts/.

Xem lệnh gọi API 
curl -s "$API/accounts/$(jq -rn --arg v "[email protected]" '$v|@uri')" \
  -H "Authorization: Bearer $USEAPI_TOKEN" | jq '{plan_name, credits, maxJobs, costs}'

curl -s -X POST "$API/accounts" \
  -H "Authorization: Bearer $USEAPI_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "email": "[email protected]", "maxJobs": 2 }'

Dùng từ Claude, ChatGPT hoặc Cursor (MCP)

Các tính năng này cũng có dưới dạng một MCP server được host sẵn với 15 công cụ, từ bài hát, cover và mashup đến stem, bản nhạc và upload. ACE Music không có tích hợp MCP công khai của riêng mình (tính đến tháng 11/2026). Trong Claude Code chỉ cần một lệnh:

claude mcp add --transport http useapi-acemusic https://api.useapi.net/v1/acemusic/mcp --header "Authorization: Bearer YOUR_API_TOKEN"

Cursor, VS Code và Windsurf dùng cùng URL và header, còn ứng dụng Claude và ChatGPT đăng nhập bằng OAuth, xem Dùng trong ứng dụng Claude hoặc ChatGPT. Sau đó cứ yêu cầu bằng lời thông thường: “Write lyrics about a cat who loves rainy days and sing them as acoustic indie folk on ACE Music v1”.

Tạo hàng loạt bằng script

Repo GitHub acemusic-api có một ví dụ cho mỗi tính năng, được link từ từng phần ở trên: một script Node.js và một bản Python tương ứng, không cần cài đặt gì. Mỗi script đọc request từ file prompts.json mà bạn chỉnh sửa, chạy tối đa 4 request cùng lúc, poll các job, và lưu cả hai bài hát, ảnh bìa, bản ghi job và file ledger.jsonl ghi số credit đã dùng vào thư mục output/ của nó.

Bạn cần Node.js 21 trở lên hoặc Python 3.8 trở lên. --only 3 chạy prompt thứ ba bên dưới, một bài ACE-Step không tốn credit, nên chạy được trên tài khoản Free:

git clone https://github.com/useapi/acemusic-api.git && cd acemusic-api
export USEAPI_TOKEN="user:12345-..."
node songs-from-prompt/songs-from-prompt.mjs --only 3

Mỗi bản ghi job đã lưu chứa songId của các bài hát, và --from <job>.json --pick 1 chuyển bài số 1 sang script tiếp theo để cover, mashup hoặc tách stem.

Mở songs-from-prompt/prompts.json 
[
    {
        "_about": "ACE Music v1 (the default model, 4 credits for two songs): ACE Music writes the style, lyrics and title from your idea",
        "prompt": "A late-night neo-soul slow jam about two strangers sharing an umbrella at a bus stop in the rain and missing the last bus on purpose. Warm Rhodes piano, brushed drums, round upright bass, a smoky female lead with close three-part harmonies on the chorus.",
        "model": "acemusic-v1"
    },
    {
        "_about": "ACE Music v1.1 Preview (4 credits): writes a score first, then the audio",
        "prompt": "An anthemic Celtic folk-rock singalong about a fishing crew racing a storm back to the harbor. Fiddle and tin whistle hooks, stomping kick drum, bodhran, a gravelly male lead and the whole crew shouting the chorus.",
        "model": "acemusic-v1.1"
    },
    {
        "_about": "ACE-Step v1.5 XL (no credits on any ACE Music plan, the Free plan included)",
        "prompt": "A breezy bossa nova for a lazy Sunday afternoon in Lisbon: nylon-string guitar, soft brushed snare, upright bass, a gentle flute line and a warm male and female duet sung in Portuguese.",
        "model": "ace-step-1.5-xl"
    }
]

Ví dụ

Mọi bài hát dưới đây được tạo ngày 14 tháng 11 năm 2026 (giờ PST) bằng các script của repo trên một tài khoản ACE Music Artist, và là bài đầu tiên trong hai bài của mỗi request. Tên bài do ACE Music đặt, trừ khi chúng tôi tự đặt, thời gian tính từ lúc gửi request đến khi cả hai bài xong, và các lệnh gọi dùng id bịa ra.

Bài hát từ một bức ảnh

Đưa vào một bức ảnh và một câu mô tả phong cách, nhận về hai bài hát hoàn chỉnh. Chúng tôi upload bức ảnh linh vật robot đang nhảy này và yêu cầu drum and bass, và ACE Music viết lời từ những gì nó thấy: “Teal fur shaking on the concrete floor, orange high-tops squeaking by the studio door”.

Linh vật robot lông xù màu xanh mòng két, đầu hình hộp, có ăng-ten và mắt phát sáng, đang nhảy trong đôi giày cổ cao màu cam

Bouncy, playful drum and bass for a dancing robot mascot: rolling breakbeats at
174 bpm, a wobbly reese bass, bleepy robot synth hooks, vocoder chops, cheeky and
upbeat.

ACE Music v1 — “Bleep Boop Bounce” · 2:47 · tạo trong 72 giây

Xem lệnh gọi API 
curl -X POST 'https://api.useapi.net/v1/acemusic/files' \
  -H 'Authorization: Bearer user:12345-…' \
  -H 'Content-Type: image/png' \
  --data-binary @robot-mascot.png

curl -X POST 'https://api.useapi.net/v1/acemusic/music' \
  -H 'Authorization: Bearer user:12345-…' \
  -H 'Content-Type: application/json' \
  -d '{
    "prompt": "Bouncy, playful drum and bass for a dancing robot mascot: rolling breakbeats at 174 bpm, a wobbly reese bass, bleepy robot synth hooks, vocoder chops, cheeky and upbeat.",
    "model": "acemusic-v1",
    "images": ["user:[email protected]:cx_3b9e1d7a5c2f48e0a6d4b8c1"],
    "async": true
  }'

Bài hát từ prompt

Bài hát ACE Music v1 tạo từ prompt, “Let the 44 Roll By”, nằm trong phần hướng dẫn từng bước. Thêm hai prompt nữa, trên hai model còn lại:

An anthemic Celtic folk-rock singalong about a fishing crew racing a storm back
to the harbor. Fiddle and tin whistle hooks, stomping kick drum, bodhran, a
gravelly male lead and the whole crew shouting the chorus.

ACE Music v1.1 Preview — “Haul for the Harbor Light” · 2:51 · tạo trong 43 giây

Xem lệnh gọi API 
curl -X POST 'https://api.useapi.net/v1/acemusic/music' \
  -H 'Authorization: Bearer user:12345-…' \
  -H 'Content-Type: application/json' \
  -d '{
    "prompt": "An anthemic Celtic folk-rock singalong about a fishing crew racing a storm back to the harbor. Fiddle and tin whistle hooks, stomping kick drum, bodhran, a gravelly male lead and the whole crew shouting the chorus.",
    "model": "acemusic-v1.1",
    "async": true
  }'

A breezy bossa nova for a lazy Sunday afternoon in Lisbon: nylon-string guitar,
soft brushed snare, upright bass, a gentle flute line and a warm male and female
duet sung in Portuguese.

ACE-Step v1.5 XL, không tốn credit — “Domingo em Alfama” · 3:28

Xem lệnh gọi API 
curl -X POST 'https://api.useapi.net/v1/acemusic/music' \
  -H 'Authorization: Bearer user:12345-…' \
  -H 'Content-Type: application/json' \
  -d '{
    "prompt": "A breezy bossa nova for a lazy Sunday afternoon in Lisbon: nylon-string guitar, soft brushed snare, upright bass, a gentle flute line and a warm male and female duet sung in Portuguese.",
    "model": "ace-step-1.5-xl",
    "async": true
  }'

Lời của riêng bạn

Hai đoạn verse, một pre-chorus, một bridge và một outro do chúng tôi tự viết, yêu cầu dài 210 giây:

Style:  cinematic indie pop ballad, felt piano, swelling strings, deep heartbeat
        kick, intimate female vocal that opens up into a soaring chorus, 72 bpm
Lyrics: [Verse 1] We wrote our names on paper lanterns / Down by the river in July …
        [Chorus] Light it up and let it go / Every word I never said out loud …

ACE Music v1 — “Paper Lanterns” · 3:29 · tạo trong 61 giây

Xem lệnh gọi API 
curl -X POST 'https://api.useapi.net/v1/acemusic/music' \
  -H 'Authorization: Bearer user:12345-…' \
  -H 'Content-Type: application/json' \
  -d '{
    "title": "Paper Lanterns",
    "style": "cinematic indie pop ballad, felt piano, swelling strings, deep heartbeat kick, intimate female vocal that opens up into a soaring chorus, 72 bpm",
    "lyrics": "[Verse 1]\nWe wrote our names on paper lanterns\nDown by the river in July\nYou said the wind would know the answer\nIf we just let the fire fly\nYour hand was shaking, mine was steady\nAt least that'\''s how I tell it now\nWe watched them climb until the city\nWas just a glow beneath the clouds\n\n[Pre-Chorus]\nSo every summer I come back here\nStrike a match and hold it near\n\n[Chorus]\nLight it up and let it go\nEvery word I never said out loud\nLight it up and let it go\nHigher than the both of us somehow\nAnd if it finds you anyhow\nTell me you can see it from the clouds\n\n[Verse 2]\nThey tore the old pier down last winter\nPut up a fence and painted lines\nBut I still know the way by heartbeat\nI find the water every time\nI keep a lighter in my pocket\nI keep your laugh inside my head\nI fold the paper like you showed me\nAnd write the things I should have said\n\n[Pre-Chorus]\nSo every summer I come back here\nStrike a match and hold it near\n\n[Chorus]\nLight it up and let it go\nEvery word I never said out loud\nLight it up and let it go\nHigher than the both of us somehow\nAnd if it finds you anyhow\nTell me you can see it from the clouds\n\n[Bridge]\nPaper and fire, paper and fire\nNothing this light should rise so high\nPaper and fire, paper and fire\nMaybe that'\''s how we say goodbye\n\n[Final Chorus]\nLight it up and let it go\nEvery word I never said out loud\nLight it up and let it go\nHigher than the both of us somehow\n\n[Outro]\nDown by the river in July",
    "model": "acemusic-v1",
    "duration": 210,
    "async": true
  }'

Một bản không lời: instrumental: true, 150 giây, không có giọng hát, hợp xướng hay guitar acoustic:

Style:  cinematic synthwave instrumental for a night drive: pulsing analog bass
        arpeggio, gated reverb drums, lush pads, a soaring lead synth melody,
        builds to a big final section, 108 bpm

ACE Music v1 — “Neon Overpass” · 2:29 · tạo trong 46 giây

Xem lệnh gọi API 
curl -X POST 'https://api.useapi.net/v1/acemusic/music' \
  -H 'Authorization: Bearer user:12345-…' \
  -H 'Content-Type: application/json' \
  -d '{
    "title": "Neon Overpass",
    "style": "cinematic synthwave instrumental for a night drive: pulsing analog bass arpeggio, gated reverb drums, lush pads, a soaring lead synth melody, builds to a big final section, 108 bpm",
    "instrumental": true,
    "model": "acemusic-v1",
    "duration": 150,
    "negative": "vocals, choir, acoustic guitar",
    "async": true
  }'

Lời tiếng Tây Ban Nha về một bữa tiệc trên sân thượng giữa lúc mất điện:

Style:  modern cumbia pop, bright accordion hooks, güira and congas, warm bass,
        a festive male lead with a crowd shouting the chorus, 98 bpm
Lyrics: [Chorus] Bailando en la azotea / Con las estrellas de farol …

ACE Music v1 — “Bailando en la Azotea” · 2:32 · tạo trong 46 giây

Xem lệnh gọi API 
curl -X POST 'https://api.useapi.net/v1/acemusic/music' \
  -H 'Authorization: Bearer user:12345-…' \
  -H 'Content-Type: application/json' \
  -d '{
    "title": "Bailando en la Azotea",
    "style": "modern cumbia pop, bright accordion hooks, güira and congas, warm bass, a festive male lead with a crowd shouting the chorus, 98 bpm",
    "lyrics": "[Verse 1]\nSe fue la luz en todo el barrio\nY nadie quiere irse a dormir\nDoña Rosa saca el radio viejo\nY la noche empieza a sonreír\nLos vecinos suben con sus sillas\nAlguien trae limones y café\nY la ciudad allá abajo, oscura\nNos mira bailar sin saber por qué\n\n[Pre-Chorus]\nSube, sube, que la luna está invitando\nSube, sube, que la calle está cantando\n\n[Chorus]\nBailando en la azotea\nCon las estrellas de farol\nQue se entere todo el mundo\nQue esta noche no hay apagón\nBailando en la azotea\nCon el corazón de tambor\nSi se apaga la ciudad entera\nAquí arriba sobra amor\n\n[Verse 2]\nEl abuelo saca la guitarra\nLa vecina de enfrente se animó\nLos niños corren entre las sábanas\nQue el viento de la tarde colgó\nNadie sabe cuándo vuelve la corriente\nY la verdad, a nadie le importó\nEsta fiesta no la paga nadie\nEsta fiesta la invitó el apagón\n\n[Chorus]\nBailando en la azotea\nCon las estrellas de farol\nQue se entere todo el mundo\nQue esta noche no hay apagón\nBailando en la azotea\nCon el corazón de tambor\nSi se apaga la ciudad entera\nAquí arriba sobra amor\n\n[Outro]\nQue esta noche no hay apagón",
    "model": "acemusic-v1",
    "async": true
  }'

Lời do công cụ viết lời viết, phong cách do công cụ viết phong cách viết, ACE-Step hát:

Lyrics writer: A wistful country song about an old pickup truck that still has
               her mixtape stuck in the tape deck
Style writer:  classic country ballad, pedal steel, warm baritone

ACE-Step v1.5 XL, không tốn credit — “Side B Forever” · 3:35 · tạo trong 40 giây, sau 6 giây cho phần lời và 4 giây cho phong cách

Xem lệnh gọi API 
curl -X POST 'https://api.useapi.net/v1/acemusic/music/lyrics' \
  -H 'Authorization: Bearer user:12345-…' \
  -H 'Content-Type: application/json' \
  -d '{
    "prompt": "A wistful country song about an old pickup truck that still has her mixtape stuck in the tape deck",
    "style": "classic country ballad, pedal steel, warm baritone",
    "model": "ace-step-1.5-xl"
  }' > lyrics.json

curl -X POST 'https://api.useapi.net/v1/acemusic/music/style' \
  -H 'Authorization: Bearer user:12345-…' \
  -H 'Content-Type: application/json' \
  -d '{
    "style": "classic country ballad, pedal steel, warm baritone",
    "model": "ace-step-1.5-xl"
  }' > style.json

# sing what the writers returned
jq -n --slurpfile l lyrics.json --slurpfile s style.json \
  '{title: $l[0].title, lyrics: $l[0].lyrics, style: $s[0].style, model: "ace-step-1.5-xl", async: true}' |
curl -X POST 'https://api.useapi.net/v1/acemusic/music' \
  -H 'Authorization: Bearer user:12345-…' \
  -H 'Content-Type: application/json' \
  -d @-

ACE-Step với nhịp độ, tông và số chỉ nhịp cố định

Mỗi bài đều có độ dài đúng như yêu cầu.

3/4 · 84 bpm · D minor · 120 s · thinking 60 · avoid: trap drums, EDM, autotune
Style: dark cabaret waltz, accordion, pizzicato strings, upright bass, brushed
       snare, theatrical female vocal

ACE-Step v1.5 XL, không tốn credit — “Midnight Waltz” · 2:00 · tạo trong 31 giây

Xem lệnh gọi API 
curl -X POST 'https://api.useapi.net/v1/acemusic/music' \
  -H 'Authorization: Bearer user:12345-…' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "ace-step-1.5-xl",
    "title": "Midnight Waltz",
    "style": "dark cabaret waltz, accordion, pizzicato strings, upright bass, brushed snare, theatrical female vocal",
    "lyrics": "[Verse 1]\nThe band plays slow when the lights go low\nAnd the chandeliers begin to sway\nTake my hand, we will dance till the candles stand\nIn puddles of yesterday\n\n[Chorus]\nOne, two, three, turn around with me\nRound and round till the morning comes\nOne, two, three, oh don'\''t let me be\nThe last one dancing when the music'\''s done\n\n[Verse 2]\nThe clock strikes twelve and it laughs at itself\nEvery mirror wears a stranger'\''s face\nHold me close, we are only ghosts\nWho forgot to leave this place\n\n[Chorus]\nOne, two, three, turn around with me\nRound and round till the morning comes\nOne, two, three, oh don'\''t let me be\nThe last one dancing when the music'\''s done",
    "bpm": 84,
    "timeSignature": "3/4",
    "key": "D minor",
    "duration": 120,
    "negative": "trap drums, EDM, autotune",
    "thinking": 60,
    "async": true
  }'

6/8 · 116 bpm · G major · 90 s · instrumental
Style: lively celtic instrumental jig, fiddle and tin whistle trading the melody,
       bodhran, strummed bouzouki, foot stomps

ACE-Step v1.5 XL, không tốn credit — “Harbour Jig” · 1:30 · tạo trong 20 giây

Xem lệnh gọi API 
curl -X POST 'https://api.useapi.net/v1/acemusic/music' \
  -H 'Authorization: Bearer user:12345-…' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "ace-step-1.5-xl",
    "title": "Harbour Jig",
    "style": "lively celtic instrumental jig, fiddle and tin whistle trading the melody, bodhran, strummed bouzouki, foot stomps",
    "instrumental": true,
    "bpm": 116,
    "timeSignature": "6/8",
    "key": "G major",
    "duration": 90,
    "async": true
  }'

4/4 · 174 bpm · F minor · 150 s · thinking 80
Style: liquid drum and bass, rolling breakbeats, deep warm sub bass, airy pads,
       soulful female vocal

ACE-Step v1.5 XL, không tốn credit — “Almost Home” · 2:30 · tạo trong 41 giây

Xem lệnh gọi API 
curl -X POST 'https://api.useapi.net/v1/acemusic/music' \
  -H 'Authorization: Bearer user:12345-…' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "ace-step-1.5-xl",
    "title": "Almost Home",
    "style": "liquid drum and bass, rolling breakbeats, deep warm sub bass, airy pads, soulful female vocal",
    "lyrics": "[Verse]\nCity lights in the rear view mirror\nRunning on a borrowed night\nEvery bridge is a little bit nearer\nEvery tunnel full of light\n\n[Chorus]\nHold on, we'\''re almost home\nEvery signal turning green\nHold on, you'\''re not alone\nFaster than the in-between\n\n[Verse]\nRadio low and the windows open\nBreathing in the summer rain\nEvery promise we left unspoken\nRushing back to us again\n\n[Chorus]\nHold on, we'\''re almost home\nEvery signal turning green\nHold on, you'\''re not alone\nFaster than the in-between",
    "bpm": 174,
    "timeSignature": "4/4",
    "key": "F minor",
    "duration": 150,
    "thinking": 80,
    "async": true
  }'

Một bản cover, một bản remix và một bản chỉnh sửa

“Paper Lanterns” dưới dạng cover, theo phong cách mới mà vẫn giữ giai điệu:

mode: cover · stripped-back acoustic folk cover, fingerpicked steel-string guitar,
warm cello, soft close-mic'd male vocal

ACE Music v1.1 Preview — “Paper Lanterns (Acoustic Folk Cover)” · 3:34 · tạo trong 72 giây

Xem lệnh gọi API 
# our script read the score first (free for an ACE Music v1 song; the API now does this by itself)
curl 'https://api.useapi.net/v1/acemusic/music/score?songId=user%3A12345-example%40example.com-song%3Aso_4e7b2c9d0a5f4183b6d8e2c7' \
  -H 'Authorization: Bearer user:12345-…' > /dev/null

curl -X POST 'https://api.useapi.net/v1/acemusic/music' \
  -H 'Authorization: Bearer user:12345-…' \
  -H 'Content-Type: application/json' \
  -d '{
    "mode": "cover",
    "model": "acemusic-v1.1",
    "references": ["user:[email protected]:so_4e7b2c9d0a5f4183b6d8e2c7"],
    "style": "stripped-back acoustic folk cover, fingerpicked steel-string guitar, warm cello, soft close-mic'\''d male vocal",
    "async": true
  }'

“Bailando en la Azotea” thành deep house. Chúng tôi không gửi tên bài, nên ACE Music đặt tên là “Reference 1”:

mode: remix · coverStrength 40 · remixStrength 50 · deep house remix,
four-on-the-floor kick, plucky chords, rolling bassline, filtered vocal chops

ACE-Step v1.5 XL, không tốn credit — “Reference 1” · 2:32 · tạo trong 31 giây

Xem lệnh gọi API 
curl -X POST 'https://api.useapi.net/v1/acemusic/music' \
  -H 'Authorization: Bearer user:12345-…' \
  -H 'Content-Type: application/json' \
  -d '{
    "mode": "remix",
    "model": "ace-step-1.5-xl",
    "references": ["user:[email protected]:so_9d3b7e2c1a6f4085b8e4d1c6"],
    "style": "deep house remix, four-on-the-floor kick, plucky chords, rolling bassline, filtered vocal chops",
    "coverStrength": 40,
    "remixStrength": 50,
    "async": true
  }'

“Paper Lanterns” với lời mới cho giây 30 đến 50, giữ nguyên phần còn lại:

mode: edit · start 30 · end 50
Lyrics: We wrote our names on paper lanterns / Down by the harbor in the snow /
        You said the stars would keep the answer / If we were brave enough to go

ACE-Step v1.5 XL, không tốn credit — “Reference 1” · 3:29 · tạo trong 41 giây

Xem lệnh gọi API 
curl -X POST 'https://api.useapi.net/v1/acemusic/music' \
  -H 'Authorization: Bearer user:12345-…' \
  -H 'Content-Type: application/json' \
  -d '{
    "mode": "edit",
    "model": "ace-step-1.5-xl",
    "references": ["user:[email protected]:so_4e7b2c9d0a5f4183b6d8e2c7"],
    "start": 30,
    "end": 50,
    "style": "cinematic indie pop ballad, felt piano, swelling strings, intimate female vocal",
    "lyrics": "We wrote our names on paper lanterns\nDown by the harbor in the snow\nYou said the stars would keep the answer\nIf we were brave enough to go",
    "async": true
  }'

Mashup

“Paper Lanterns” và “Let the 44 Roll By”:

upbeat neo-soul pop mashup, punchy live drums, warm Rhodes and strings, female
lead with a gospel-tinged choir on the chorus · audioInfluence 60

ACE Music v1.1 Preview — “Lanterns at the Bus Stop” · 3:58 · tạo trong 83 giây

Xem lệnh gọi API 
# our script read each song's score first (the API now does this by itself for ACE Music v1 songs)
curl -X POST 'https://api.useapi.net/v1/acemusic/music' \
  -H 'Authorization: Bearer user:12345-…' \
  -H 'Content-Type: application/json' \
  -d '{
    "mode": "mashup",
    "model": "acemusic-v1.1",
    "references": ["user:[email protected]:so_4e7b2c9d0a5f4183b6d8e2c7", "user:[email protected]:so_7c1d9e3a5b2f4806a4e1c9d3"],
    "title": "Lanterns at the Bus Stop",
    "style": "upbeat neo-soul pop mashup, punchy live drums, warm Rhodes and strings, female lead with a gospel-tinged choir on the chorus",
    "audioInfluence": 60,
    "async": true
  }'

“Haul for the Harbor Light” và “Bailando en la Azotea”, yêu cầu trên ACE Music v1:

festive celtic cumbia mashup, fiddle and accordion trading hooks, congas and
bodhran, stomping kick, male lead with a big crowd chorus

ACE Music v1.1 Preview (yêu cầu: v1) — “Harbor Fiesta” · 2:38 · tạo trong 74 giây

Xem lệnh gọi API 
# our script read each song's score first (the API now does this by itself for ACE Music v1 songs)
curl -X POST 'https://api.useapi.net/v1/acemusic/music' \
  -H 'Authorization: Bearer user:12345-…' \
  -H 'Content-Type: application/json' \
  -d '{
    "mode": "mashup",
    "model": "acemusic-v1",
    "references": ["user:[email protected]:so_2a8f6c1e9d4b47f3b0c5e8a2", "user:[email protected]:so_9d3b7e2c1a6f4085b8e4d1c6"],
    "title": "Harbor Fiesta",
    "style": "festive celtic cumbia mashup, fiddle and accordion trading hooks, congas and bodhran, stomping kick, male lead with a big crowd chorus",
    "async": true
  }'

Ba bài hát cùng lúc: “Paper Lanterns”, “Bailando en la Azotea” và “Let the 44 Roll By”:

warm late-night soul-pop medley, Rhodes and strings, light latin percussion,
female lead with a male answer on the last chorus

ACE Music v1.1 Preview — “Three Songs, One Night” · 3:32 · tạo trong 43 giây

Xem lệnh gọi API 
# our script read each song's score first (the API now does this by itself for ACE Music v1 songs)
curl -X POST 'https://api.useapi.net/v1/acemusic/music' \
  -H 'Authorization: Bearer user:12345-…' \
  -H 'Content-Type: application/json' \
  -d '{
    "mode": "mashup",
    "model": "acemusic-v1.1",
    "references": ["user:[email protected]:so_4e7b2c9d0a5f4183b6d8e2c7", "user:[email protected]:so_9d3b7e2c1a6f4085b8e4d1c6", "user:[email protected]:so_7c1d9e3a5b2f4806a4e1c9d3"],
    "title": "Three Songs, One Night",
    "style": "warm late-night soul-pop medley, Rhodes and strings, light latin percussion, female lead with a male answer on the last chorus",
    "async": true
  }'

Âm thanh và hình ảnh của bạn

Bản “Harbour Jig” ở trên, được upload dưới dạng MP3 và dùng làm tham chiếu cho một prompt. ACE Music chạy nó trên v1.1 để giữ giai điệu:

A rowdy pub singalong with a big shouted chorus about the last ferry home, built
on the tune of this recording

ACE Music v1.1 Preview (yêu cầu: v1) — “Last Ferry Home” · 1:36 · tạo trong 52 giây

Xem lệnh gọi API 
curl -X POST 'https://api.useapi.net/v1/acemusic/files?title=Harbour%20Jig%20demo' \
  -H 'Authorization: Bearer user:12345-…' \
  -H 'Content-Type: audio/mpeg' \
  --data-binary @harbour-jig-demo.mp3

curl -X POST 'https://api.useapi.net/v1/acemusic/music' \
  -H 'Authorization: Bearer user:12345-…' \
  -H 'Content-Type: application/json' \
  -d '{
    "prompt": "A rowdy pub singalong with a big shouted chorus about the last ferry home, built on the tune of this recording",
    "model": "acemusic-v1",
    "references": ["user:[email protected]:so_5f1a3c8e7b2d49a6c3e0f7b9"],
    "async": true
  }'

Các stem của “Paper Lanterns”

Giọng hát và nhạc nền từ mode: "vocals" (5 credit), sau đó là trống và dàn dây trong 9 stem từ mode: "all" (60 credit).

Xem lệnh gọi API 
curl -X POST 'https://api.useapi.net/v1/acemusic/music/stems' \
  -H 'Authorization: Bearer user:12345-…' \
  -H 'Content-Type: application/json' \
  -d '{
    "songId": "user:[email protected]:so_4e7b2c9d0a5f4183b6d8e2c7",
    "mode": "vocals",
    "async": true
  }'

curl -X POST 'https://api.useapi.net/v1/acemusic/music/stems' \
  -H 'Authorization: Bearer user:12345-…' \
  -H 'Content-Type: application/json' \
  -d '{
    "songId": "user:[email protected]:so_4e7b2c9d0a5f4183b6d8e2c7",
    "mode": "all",
    "async": true
  }'

Câu hỏi thường gặp

Có API ACE Music không?
Qua useapi.net thì có: ACE Music API chạy ACE Music v1, ACE Music v1.1 Preview và ACE-Step v1.5 XL qua REST trên tài khoản ACE Music của bạn, có cover, mashup, stem và MIDI. ACE Music v1 và v1.1 không có API công khai riêng (tính đến tháng 11/2026), nên useapi.net là cách duy nhất để gọi chúng từ code. API riêng của ACE Music chạy ACE-Step v1.5 cũ hơn và đã tạm dừng đăng ký API key mới.

Có API ACE-Step miễn phí không?
Qua useapi.net thì có: một bài hát ACE-Step v1.5 XL không tốn credit trên bất kỳ gói ACE Music nào, kể cả gói Free, với các thiết lập nhịp độ, tông, số chỉ nhịp và độ dài, cùng remix và chỉnh sửa. Bên thứ ba acestep.io chỉ cung cấp API ACE-Step trên gói Studio $49 một tháng, khoảng $0,14 một bài (tính đến tháng 11/2026).

Một bài hát ACE Music v1 qua API giá bao nhiêu?
Qua useapi.net, một bài hát ACE Music v1 tốn 2 credit trong gói ACE Music của bạn: $0,013 trên Artist trả theo năm và $0,023 trên Artist trả theo tháng, không cộng thêm gì theo bài hát. ACE Music v1 không được bán qua bất kỳ API công khai nào (tính đến tháng 11/2026), nên credit trong gói của bạn là cách duy nhất để trả tiền cho nó theo từng bài từ code. Xem Giá.

Có MCP server cho ACE Music không?
Qua useapi.net thì có: một ACE Music MCP server được host sẵn với 15 công cụ cho phép ứng dụng Claude, ChatGPT, Claude Code và Cursor tạo bài hát, cover, mashup và stem trên tài khoản ACE Music của bạn, không cần cài đặt gì. ACE Music không có tích hợp MCP công khai của riêng mình (tính đến tháng 11/2026).

Kết luận

Một lệnh POST tạo hai bài hát trên model dẫn đầu bảng xếp hạng giọng hát, bài hát ACE-Step không tốn gì, và mọi bài hát đều có thể đi tiếp thành cover, mashup, stem hoặc file MIDI ở lệnh gọi kế tiếp. Clone repo acemusic-api, chạy songs-from-prompt/ với --only 3 trên tài khoản Free, và xem POST /music để biết mọi tùy chọn.

Ghé Discord Server hoặc Telegram Channel của chúng tôi cho mọi câu hỏi hỗ trợ.