วิธีสร้างเพลง AI ด้วย ACE Music API

อ่าน 22 นาที • 14 พฤศจิกายน 2026

สารบัญ

  1. บทนำ
  2. โมเดลและสิ่งที่ API ทำได้
  3. ราคา
  4. วิธีสร้างเพลงด้วย curl
    1. เพิ่มบัญชี ACE Music ของคุณ
    2. สร้างเพลงจากพรอมต์
    3. สิ่งที่ได้กลับมา
    4. แบบ sync, async และ webhook
  5. ร้องเนื้อเพลงของคุณเอง
  6. กำหนดจังหวะ คีย์ และอัตราจังหวะด้วย ACE-Step
  7. คัฟเวอร์ รีมิกซ์ และการแก้ไข
    1. แมชอัปสองหรือสามเพลง
  8. กำหนดทิศทางเพลงด้วยไฟล์เสียงและภาพของคุณเอง
  9. สเต็ม การดาวน์โหลด และโน้ตเพลง
    1. แยกเพลงเป็นสเต็ม
    2. ดาวน์โหลด MP3, WAV, MIDI และ MusicXML
    3. อ่านโน้ตเพลง
  10. ไลบรารีของคุณ
  11. ใช้หลายบัญชี ACE Music
  12. ใช้จาก Claude, ChatGPT หรือ Cursor (MCP)
  13. สร้างเป็นชุดด้วยสคริปต์
  14. ตัวอย่าง
    1. เพลงจากภาพ
    2. เพลงจากพรอมต์
    3. เนื้อเพลงของคุณเอง
    4. ACE-Step ที่จังหวะ คีย์ และอัตราจังหวะที่กำหนด
    5. คัฟเวอร์ รีมิกซ์ และการแก้ไข
    6. แมชอัป
    7. ไฟล์เสียงและภาพของคุณ
    8. สเต็มของ “Paper Lanterns”
  15. คำถามที่พบบ่อย
  16. สรุป

บทนำ

ACE Music API ของ useapi.net เปลี่ยนการเรียก REST ครั้งเดียวให้เป็นเพลงที่เสร็จสมบูรณ์สองเพลงจาก ACE Music พร้อมเสียงร้อง เนื้อเพลง ชื่อเพลง และภาพปก โดยใช้แพ็กเกจ ACE Music ที่คุณมีอยู่แล้ว ACE Music v1 อยู่อันดับ 1 บนตารางอันดับโมเดลเพลงที่มีเสียงร้องของ Artificial Analysis นำหน้า Suno v6 และ ACE Music v1 กับ v1.1 ไม่มี API สาธารณะของตัวเอง (ข้อมูล ณ พฤศจิกายน 2026) useapi.net จึงเป็นทางเดียวที่จะเรียกใช้โมเดลเหล่านี้จากโค้ด ส่วน ACE-Step v1.5 XL แบบโอเพนซอร์สก็ทำงานผ่าน API เดียวกัน โดยไม่ใช้เครดิตในทุกแพ็กเกจ ACE Music รวมถึงแพ็กเกจ Free

คู่มือนี้เริ่มจากสามโมเดลและค่าใช้จ่ายต่อเพลง จากนั้นสร้างเพลงหนึ่งเพลงตั้งแต่ต้นจนจบด้วย curl แล้วสรุปฟีเจอร์อื่นทั้งหมดไว้ในตารางสั้นๆ ส่วนตัวอย่างท้ายบทความคือเพลง 18 เพลงที่เราสร้างสำหรับหน้านี้ แต่ละเพลงแนบคำขอที่ใช้สร้างไว้ด้วย ทั้งหมดสร้างจากสคริปต์ใน GitHub repo acemusic-api (Node.js และ Python) ใช้ไป 117 เครดิตของแพ็กเกจ Artist รวมเทคที่สร้างเพิ่มแล้ว useapi.net เป็น API ของบุคคลที่สาม ไม่มีส่วนเกี่ยวข้องกับ ACE Music หรือ Timedomain ผู้พัฒนา ACE Music

โมเดลและสิ่งที่ API ทำได้

ทุกคำขอสร้างเพลงสองเพลง และ model เป็นตัวกำหนดว่าโมเดลไหนเป็นผู้สร้าง:

โมเดล model ใช้ทำอะไร การตั้งค่า เครดิตต่อคำขอ เวลาในการทดสอบของเรา
ACE Music v1 acemusic-v1 (ค่าเริ่มต้น) โมเดลเสียงร้องอันดับ 1: เพลงจากพรอมต์หรือจากเนื้อเพลงของคุณ แบบมีเสียงร้องหรือบรรเลง duration 30 ถึง 600 วินาที, negative, styleInfluence, ดาวน์โหลด WAV 4 46 ถึง 89 วินาที
ACE Music v1.1 Preview acemusic-v1.1 เขียนโน้ตเพลง (score) ก่อน คัฟเวอร์และแมชอัปจึงตามทำนองของเพลงต้นทาง audioInfluence, styleInfluence 4 35 ถึง 83 วินาที
ACE-Step v1.5 XL ace-step-1.5-xl โอเพนซอร์สโดย ACE Studio และ StepFun: เพลง รีมิกซ์ และการแก้ไข bpm, key, timeSignature, duration 10 ถึง 240 วินาที, negative, thinking ได้ไฟล์ MP3 เท่านั้น 0 20 ถึง 55 วินาที

สิ่งที่ทำได้กับโมเดลเหล่านี้:

สิ่งที่ทำ คำขอ หมายเหตุ
เพลงจากพรอมต์ POST /music prompt ACE Music เขียนสไตล์ เนื้อเพลง และชื่อเพลงให้
เนื้อเพลงของคุณเอง เพลงบรรเลง POST /music style, lyrics ภาษาใดก็ได้
ตัวช่วยเขียนเนื้อเพลงและสไตล์ POST /music/lyrics, /music/style ไม่ใช้เครดิต
คัฟเวอร์ รีมิกซ์ แก้ไข แมชอัป POST /music mode ใช้กับเพลงใดก็ได้ในบัญชี
ไฟล์เสียงและภาพของคุณ POST /files ใช้เป็นข้อมูลอ้างอิงสำหรับเพลงใหม่
สเต็ม (stems) POST /music/stems Creator และ Artist
ดาวน์โหลด โน้ตเพลง GET /music/download, /music/score MP3 และโน้ตเพลงได้ทุกแพ็กเกจ ส่วน WAV, MIDI และ MusicXML ได้ใน Creator และ Artist
ไลบรารี งาน บัญชี GET /music, /jobs, /accounts ทุกเพลงในบัญชี งานที่กำลังทำงาน เครดิตแบบเรียลไทม์
MCP server /v1/acemusic/mcp 15 เครื่องมือสำหรับผู้ช่วย AI

ราคา

ACE Music คิดเครดิตของตัวเองต่อคำขอจากแพ็กเกจ ACE Music ของคุณ และ useapi.net ไม่คิดเงินเพิ่มต่อเพลง (ข้อมูล ณ พฤศจิกายน 2026):

คำขอ เครดิต
เพลงสองเพลงบน ACE Music v1 หรือ v1.1 4
สเต็ม เสียงร้อง + ดนตรี 5, แพ็กเกจแบบชำระเงิน
สเต็ม ทุกสเต็ม 60, แพ็กเกจแบบชำระเงิน
โน้ตเพลงของเพลง ACE-Step อ่านครั้งแรก 1
เพลงสองเพลงบน ACE-Step v1.5 XL 0 ในทุกแพ็กเกจ
ตัวช่วยเขียนเนื้อเพลงและสไตล์ การอัปโหลด การดาวน์โหลด 0 ในการทดสอบของเรา

แพ็กเกจของ ACE Music มี Free ที่ได้ 20 เครดิตต่อวัน, Creator $9.90 ต่อเดือนสำหรับ 1,000 เครดิต และ Artist $29 ต่อเดือนสำหรับ 2,500 เครดิต หรือ $7.90 และ $16.58 ต่อเดือนเมื่อชำระรายปี หนึ่งเพลงคือครึ่งคำขอ เท่ากับ 2 เครดิต ภาพรวม API ก็มีตารางเดียวกันนี้

ค่าใช้จ่ายต่อหนึ่งเพลงในแต่ละแพ็กเกจ เรียงจากถูกที่สุดทางซ้าย (หนึ่งคำขอสร้างสองเพลง หนึ่งเพลงจึงใช้เครดิตครึ่งหนึ่งของคำขอ ข้อมูล ณ พฤศจิกายน 2026):

โมเดล Free
20 cr/วัน		 Artist $16.58/เดือน
2,500 cr/เดือน, ชำระรายปี		 Creator $7.90/เดือน
1,000 cr/เดือน, ชำระรายปี		 Creator $9.90/เดือน
1,000 cr/เดือน		 Artist $29/เดือน
2,500 cr/เดือน
ACE Music v1, v1.1
หนึ่งเพลง		 $0 / 2 cr
10 เพลง/วัน		 $0.013 / 2 cr
1,250 เพลง/เดือน		 $0.016 / 2 cr
500 เพลง/เดือน		 $0.020 / 2 cr
500 เพลง/เดือน		 $0.023 / 2 cr
1,250 เพลง/เดือน
สเต็ม
เสียงร้อง + ดนตรี		 แพ็กเกจเสียเงิน $0.033 / 5 cr $0.040 / 5 cr $0.050 / 5 cr $0.058 / 5 cr
สเต็ม
ทุกสเต็ม		 แพ็กเกจเสียเงิน $0.40 / 60 cr $0.47 / 60 cr $0.59 / 60 cr $0.70 / 60 cr
โน้ตเพลง ACE-Step
อ่านครั้งแรก		 $0 / 1 cr $0.007 / 1 cr $0.008 / 1 cr $0.010 / 1 cr $0.012 / 1 cr
ACE-Step v1.5 XL
หนึ่งเพลง		 $0 / 0 cr $0 / 0 cr $0 / 0 cr $0 / 0 cr $0 / 0 cr

เทียบกับช่องทางอื่นในการเรียกโมเดลเหล่านี้จากโค้ด:

โมเดล useapi.net API อื่น
ACE Music v1, v1.1 Preview เริ่มต้น $0.013 ต่อเพลงบน Artist แบบชำระรายปี และ $0 ด้วยเครดิตรายวัน 20 เครดิตของแพ็กเกจ Free ไม่มี: ACE Music ไม่มี API สาธารณะสำหรับโมเดลเหล่านี้
ACE-Step v1.5 XL $0 ในทุกแพ็กเกจ ACE Music รวมถึงแพ็กเกจ Free ประมาณ $0.14 ต่อเพลงบน API ของ acestep.io ซึ่งเป็นบุคคลที่สาม และต้องใช้แพ็กเกจ Studio $49 ต่อเดือน

ในทุกแพ็กเกจ ACE Music รวมถึงแพ็กเกจ Free เพลง ACE-Step v1.5 XL ไม่ใช้เครดิตเลย เทียบกับ API ของ acestep.io ซึ่งเป็นบุคคลที่สาม ที่ต้องใช้แพ็กเกจ Studio $49 ต่อเดือน (ประมาณ 360 เพลงต่อเดือน ราว $0.14 ต่อเพลง ข้อมูล ณ พฤศจิกายน 2026)

เริ่มใช้งาน API

การสมัครสมาชิกเดือนละ $15 ใช้ได้กับทุก API บน useapi.net ใช้ Token เดียวกับทุกบริการ เชื่อมบัญชีของคุณเองได้สูงสุด 3 บัญชีต่อบริการ แต่ละบัญชีใช้แพ็กเกจของเว็บไซต์นั้นเอง ส่วน useapi.net ดูแล REST API การกระจายโหลด และการ polling ให้ ต้องการบัญชีมากกว่านี้? สมัครเพิ่มแต่ละครั้งเดือนละ $10 และได้เพิ่มอีก 3 บัญชีต่อบริการ

สมัครสมาชิก — $15/เดือน ชำระด้วยคริปโต

ไม่มีบัตรเครดิตที่ใช้จ่ายต่างประเทศได้? สมัครด้วยคริปโตก็ได้ (การชำระด้วยคริปโตขอคืนเงินไม่ได้) ดูราคาและแพ็กเกจสำหรับปริมาณมากได้ที่หน้าการสมัครสมาชิก ถ้าชำระผ่าน Stripe ขอคืนเงินเต็มจำนวนได้ภายใน 14 วันหลังซื้อครั้งแรก หากสร้างงานสำเร็จไม่ถึง 50 ครั้ง สมัครไว้แล้ว? เปลี่ยนจำนวนได้ที่ Stripe Customer Portal โดยไม่ต้องซื้อใหม่

วิธีสร้างเพลงด้วย curl

คุณต้องมี API token ของ useapi.net ดูที่ ตั้งค่า useapi.net และบัญชี ACE Music ที่มีอีเมลและรหัสผ่าน การสมัครสมาชิกเดือนละ $15 ครั้งเดียวครอบคลุมทุก API ของ useapi.net และบัญชี ACE Music 3 บัญชี บัญชี ACE Music แบบ Free ก็ใช้ได้ เพราะได้ 20 เครดิตต่อวัน และเพลง ACE-Step ไม่ใช้เครดิตเลย คำสั่งด้านล่างใช้ jq ในการอ่าน JSON

เพิ่มบัญชี ACE Music ของคุณ

export token ก่อน แล้วเพิ่มบัญชีเพียงครั้งเดียว API จะล็อกอิน อ่านข้อมูลบัญชี และจัดเก็บบัญชีไว้ก็ต่อเมื่อ ACE Music ยอมรับรหัสผ่านเท่านั้น:

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" }'

บัญชีที่สร้างด้วย Continue with Google หรือด้วยหมายเลขโทรศัพท์ต้องตั้งรหัสผ่านก่อน ดูที่ ตั้งค่า ACE Music ซึ่งเพิ่มบัญชีให้คุณได้ด้วย

สร้างเพลงจากพรอมต์

บรรยายเพลงด้วยคำพูดของคุณเอง ACE Music จะเขียนสไตล์ เนื้อเพลง และชื่อเพลง แล้วสร้างเพลงสองเพลง นี่คือคำขอจริงที่ใช้สร้างเพลงแรกในหน้านี้:

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}'

เมื่อตั้ง async: true API จะตอบ 201 พร้อมข้อมูลงานทันที พรอมต์ยาวได้สูงสุด 2,000 ตัวอักษร และแนบเพลงอ้างอิงได้สูงสุด 3 เพลงกับภาพได้สูงสุด 3 ภาพ ดูที่ กำหนดทิศทางเพลงด้วยไฟล์เสียงและภาพของคุณเอง

สิ่งที่ได้กลับมา

ระหว่างที่ ACE Music เขียนเนื้อเพลง เพลงจะอยู่ในสถานะ planning และมีชื่อ Untitled จากนั้นเปลี่ยนเป็น queued และ running ให้โพล GET /jobs/jobid ทุกราว 10 วินาที jobid มีอักขระ : และ @ จึงต้อง URL-encode ก่อน:

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}]}'

เมื่อ status เป็น completed แต่ละเพลงจะมีลิงก์ของตัวเอง (id ด้านล่างเป็นค่าสมมติ):

{
  "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 คือลิงก์ MP3 สาธารณะของเพลง และไม่มีวันเปลี่ยน ส่วน playUrl เป็นลิงก์ตรงไปยัง MP3 ไฟล์เดียวกันสำหรับเครื่องเล่นบนเว็บ ใช้ได้จนถึงเวลา playUrlExpires (ประมาณหนึ่งชั่วโมง) เพราะบางเบราว์เซอร์ เช่น Brave บล็อกการ redirect ที่อยู่เบื้องหลัง audioUrl
  • songId คือค่าที่คัฟเวอร์ แมชอัป สเต็ม การดาวน์โหลด และโน้ตเพลงต้องใช้ ค่านี้ระบุบัญชีที่เพลงนั้นอยู่ การเรียกเหล่านั้นจึงทำงานบนบัญชีนั้น
  • model คือโมเดลที่คุณขอ ส่วน modelUsed คือโมเดลที่ทำงานจริง (ดูแมชอัป) kind เป็น original, cover, edit, mashup หรือ upload และ score บอกว่าเพลงนั้นมีโน้ตเพลงแล้วหรือยัง
  • เพลงที่ ACE Music สร้างไม่สำเร็จจะมี status: "failed" พร้อมเหตุผลของ ACE Music ใน error และ refunded: true เมื่อได้เครดิตคืนแล้ว

และนี่คือเพลงแรกจากสองเพลงนั้น:

ACE Music v1 — “Let the 44 Roll By” · 4:37 · สร้างใน 89 วินาที

แบบ sync, async และ webhook

สิ่งที่คุณส่ง การตอบกลับของ POST ขั้นต่อไป
async: true 201 ทันที พร้อมข้อมูลงาน โพล GET /jobs/jobid
ไม่ส่ง async 200 พร้อมงานที่เสร็จแล้ว เป็น JSON แบบเดียวกับด้านบน อ่านเพลงจากการตอบกลับ คำขอที่ยังทำงานอยู่หลัง 100 วินาทีจะตอบ 202 พร้อมข้อมูลงาน ให้โพลต่อ
replyUrl และ replyRef เหมือนด้านบน ทั้งแบบ sync และ async URL https สาธารณะของคุณจะได้รับ POST หนึ่งครั้งพร้อมงานที่เสร็จแล้ว โดยมี replyRef ของคุณอยู่ข้างใน

คำขอ ACE-Step ของเราที่ไม่ได้ส่ง async ตอบกลับมาใน 37 วินาที และ webhook มาถึง 12 วินาทีหลังเพลงเสร็จ อ่านข้อมูลงานได้นาน 7 วัน และงานที่ยังทำงานอยู่ 30 นาทีหลังเริ่มจะล้มเหลวด้วย 504 ตัวอย่าง async-webhooks/ รันครบทั้งสามแบบ และมีตัวรับ webhook ขนาดเล็กมาให้ด้วย

แสดงการเรียก 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}]}'

ร้องเนื้อเพลงของคุณเอง

ส่ง style และ lyrics แทน prompt แล้ว ACE Music จะร้องคำของคุณในสไตล์ที่คุณกำหนด:

ฟิลด์ หน้าที่ ข้อจำกัด
style แนวเพลง เครื่องดนตรี อารมณ์ จังหวะ และเสียงร้อง 1,000 ตัวอักษร, 512 บน ACE-Step
lyrics คำของคุณ ภาษาใดก็ได้ พร้อมแท็ก [Verse], [Chorus], [Bridge] 5,000 ตัวอักษร, 2,000 บน ACE-Step
title ชื่อของเพลง ถ้าไม่ส่ง ACE Music จะตั้งให้ 80 ตัวอักษร
instrumental true สำหรับเพลงไม่มีเสียงร้อง ส่ง style โดยไม่มี lyrics ก็ได้ผลเหมือนกัน  
duration ความยาวเป็นวินาที 30 ถึง 600 บน ACE Music v1, 10 ถึง 240 บน ACE-Step
negative สไตล์ที่ไม่ต้องการ 200 ตัวอักษร, ACE Music v1 และ ACE-Step
styleInfluence ความเคร่งครัดในการทำตามสไตล์ 0 ถึง 100, ค่าเริ่มต้น 80, ACE Music v1 และ v1.1

อย่าส่ง prompt พร้อมกับฟิลด์เหล่านี้ เพราะ API จะตอบ 400 และบอกว่าต้องเอาฟิลด์ไหนออก เพลงบัลลาดของเราที่ขอ duration: 210 ได้กลับมายาว 210 และ 209 วินาที เพลงนี้อยู่ในตัวอย่าง พร้อมเพลงบรรเลงและเพลงภาษาสเปน

ยังไม่มีเนื้อเพลง? POST /music/lyrics เขียนเนื้อเพลงและชื่อเพลงจากคำขอของคุณ และ POST /music/style ขยายคำไม่กี่คำให้เป็นสไตล์เต็มรูปแบบ ของเราได้ผลกลับมาใน 6 และ 4 วินาที โดยไม่เสียเครดิต สคริปต์: custom-lyrics/

กำหนดจังหวะ คีย์ และอัตราจังหวะด้วย ACE-Step

ACE-Step v1.5 XL รับการตั้งค่าทางดนตรีที่โมเดล ACE Music ไม่รับ และเพลงของมันไม่ใช้เครดิต:

ตัวเลือก ค่า
bpm 30 ถึง 200
timeSignature 2/4, 3/4, 4/4, 6/8
key C major ถึง B minor (C, C#, D, Eb, E, F, F#, G, Ab, A, Bb, B)
duration 10 ถึง 240 วินาที
negative สไตล์ที่ไม่ต้องการ สูงสุด 200 ตัวอักษร
thinking 0 ถึง 100: ACE-Step วางแผนทั้งเพลงก่อน ค่าต่ำจะสร้างสรรค์กว่า ค่าสูงจะสม่ำเสมอกว่า

เพลง ACE-Step ทั้งสามเพลงของเรา คือวอลซ์ 3/4 จิก 6/8 และดรัมแอนด์เบส 174 bpm ได้ความยาวตรงตามที่ขอทุกเพลง (ตัวอย่าง) ตัวเลือกเหล่านี้ใช้ได้เฉพาะใน mode generate บน ace-step-1.5-xl เท่านั้น ถ้าใช้ที่อื่น API จะตอบ 400 Parameter bpm does not apply to mode generate on acemusic-v1 สคริปต์: ace-step-options/

คัฟเวอร์ รีมิกซ์ และการแก้ไข

mode เปลี่ยนคำขอให้เป็นงานบนเพลงที่คุณมีอยู่ references รับ songId ของเพลงเหล่านั้น ได้แก่ เพลงที่ API สร้าง เพลงจากไลบรารี หรือไฟล์ที่คุณอัปโหลดเอง

mode references ทำงานบน เครดิต หน้าที่
cover 1 เพลง acemusic-v1.1 หรือ ACE-Step บน ace-step-1.5-xl 4 / 0 เพลงเดิมใน style ใหม่ โดยตามทำนอง คอร์ด และโครงสร้างของเพลง
remix 1 เพลง ace-step-1.5-xl 0 coverStrength คงต้นฉบับไว้ ส่วน remixStrength พาออกห่างจากต้นฉบับ (0 ถึง 100)
edit 1 เพลง ace-step-1.5-xl 0 เขียนช่วงระหว่างวินาที start ถึง end ใหม่ด้วย lyrics ใหม่ และคงส่วนที่เหลือไว้
mashup 2 หรือ 3 เพลง acemusic-v1.1 4 เพลงใหม่หนึ่งเพลงจากหลายเพลง ดูด้านล่าง

ACE Music v1.1 ตามทำนองที่อ่านได้จากโน้ตเพลงของเพลงต้นทาง คัฟเวอร์แรกของเราจากเพลง ACE Music v1 ที่ยังไม่มีโน้ตเพลงล้มเหลวด้วย ref_no_melody และได้ 4 เครดิตคืน ตอนนี้ API จึงอ่านโน้ตเพลงของเพลง ACE Music v1 ก่อนโดยไม่เสียค่าใช้จ่าย ก่อนทำคัฟเวอร์หรือแมชอัปด้วย v1.1 ส่วนเพลง ACE-Step จะไม่ถูกอ่านโดยอัตโนมัติ ถ้าเพลงใดตอบ 400 พร้อม ref_no_melody ให้เรียก GET /music/score กับเพลงนั้นก่อน (1 เครดิต) แล้วส่งคำขออีกครั้ง สคริปต์: covers-remix-edit/

แมชอัปสองหรือสามเพลง

mode: "mashup" สร้างเพลงหนึ่งเพลงจาก 2 หรือ 3 เพลงในบัญชีเดียวกัน โดยผสมเนื้อเพลงของทุกเพลงเข้าด้วยกัน เว้นแต่คุณจะส่ง lyrics มาเอง audioInfluence (0 ถึง 100 ค่าเริ่มต้น 60) กำหนดว่าจะตามเพลงต้นทางใกล้แค่ไหน แมชอัปต้องอ่านเพลงต้นทาง จึงทำงานบน ACE Music v1.1 Preview แม้คุณจะขอ v1 เหมือนกับบนเว็บไซต์ ACE Music เพลง “Harbor Fiesta” ของเรารายงาน "model": "acemusic-v1" และ "modelUsed": "acemusic-v1.1" และเครดิตคิดตามโมเดลที่ทำงานจริง แบบเดียวกันนี้เกิดกับ cover ที่ขอบน v1, พรอมต์ที่มีเพลงอ้างอิงมากกว่าหนึ่งเพลงบน ACE-Step และบางครั้งกับพรอมต์ที่มีเพลงอ้างอิง สคริปต์: mashup/

กำหนดทิศทางเพลงด้วยไฟล์เสียงและภาพของคุณเอง

POST /files รับไฟล์เป็น body ดิบของคำขอ พร้อม Content-Type ของไฟล์:

อัปโหลด รูปแบบ สูงสุด สิ่งที่ได้ ใช้เป็น
เสียง MP3, WAV, FLAC, OGG, M4A, AAC 100 MB, 8 นาที songId: เพลงในไลบรารี ที่ ACE Music ถอดเนื้อเพลง สไตล์ จังหวะ และทำนองไว้แล้ว หนึ่งใน references สูงสุด 3 รายการของพรอมต์ หรือเพลงที่จะคัฟเวอร์ รีมิกซ์ แก้ไข หรือแมชอัป
ภาพ JPEG, PNG, WebP 10 MB mediaId หนึ่งใน images สูงสุด 3 ภาพของพรอมต์: ACE Music จะแต่งเพลงเกี่ยวกับภาพนั้น 
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}'

ไฟล์ “Harbour Jig” ยาว 90 วินาทีที่เราอัปโหลดถูกถอดเสร็จใน 14 วินาที และ ACE Music ได้ยินเป็น 115 bpm (เราขอไว้ 116) ภาพหุ่นยนต์กำลังเต้นกลายเป็นเพลงดรัมแอนด์เบสเกี่ยวกับขนสีเขียวอมฟ้า (teal) และรองเท้าหุ้มข้อสีส้มของมัน ทั้งสองอยู่ในตัวอย่าง การอัปโหลดนับรวมในโควตาของบัญชี คือเสียง 10 นาทีบน Free, 30 นาทีบน Creator และ 60 นาทีบน Artist สคริปต์: upload-reference/

สเต็ม การดาวน์โหลด และโน้ตเพลง

ทุกเพลงที่เสร็จแล้วแยกสเต็ม ดาวน์โหลด และอ่านเป็นโน้ตเพลงได้:

คำขอ แพ็กเกจ เครดิต สิ่งที่ได้
สเต็ม, mode: "vocals" Creator, Artist 5 MP3 ของ vocal และ instrumental
สเต็ม, mode: "all" Creator, Artist 60 ทุกสเต็มที่ ACE Music แยกได้ เป็น MP3
ดาวน์โหลด mp3 (ค่าเริ่มต้น) ทุกแพ็กเกจ 0 url (เหมือน audioUrl) และ playUrl
ดาวน์โหลด wav Creator, Artist 0 ลิงก์ที่ใช้ได้ 24 ชั่วโมง ไม่รองรับเพลง ACE-Step
ดาวน์โหลด midi, musicxml Creator, Artist 0 ตัวไฟล์โดยตรง
โน้ตเพลง ทุกแพ็กเกจ 0, หรือ 1 สำหรับเพลง ACE-Step ในครั้งแรก สัญกรณ์ ABC: ทำนองร้อง แนวดนตรีหนึ่งแนว คอร์ด และท่อนต่างๆ

แยกเพลงเป็นสเต็ม

การแยกเสียงร้องของ “Paper Lanterns” ใช้เวลาราว 80 วินาที และการแยกเต็มรูปแบบใช้ไม่ถึง 2 นาที ได้ 9 สเต็ม ได้แก่ เสียงร้อง เสียงประสาน กลอง เบส กีตาร์ คีย์บอร์ด เครื่องสาย ซินธ์ และเอฟเฟกต์ (ฟัง) ลิงก์สเต็มใช้ได้ 24 ชั่วโมง จึงต้องอ่านเพลงอีกครั้งเพื่อรับลิงก์ใหม่ การแยกเพลงซ้ำในโหมดเดิมจะตอบทันทีและไม่คิดเครดิต

ดาวน์โหลด MP3, WAV, MIDI และ MusicXML

ACE Music สร้าง WAV, MIDI และ MusicXML เมื่อมีคำขอครั้งแรก API จะรอได้สูงสุดหนึ่งนาที แล้วตอบ 202 ให้เรียกอีกครั้งในอีกหนึ่งนาที สำหรับ “Paper Lanterns” ทั้งสามไฟล์พร้อมภายในไม่กี่วินาที ได้แก่ WAV ขนาด 40 MB, ไฟล์ MIDI ขนาด 8 KB และโน้ตเพลง MusicXML ขนาด 107 KB

แสดงการเรียก 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

อ่านโน้ตเพลง

เครื่องมือ ABC ใดก็ได้แปลงโน้ตเพลงนี้เป็นแผ่นโน้ตได้ สำหรับ “Paper Lanterns” อ่านได้ 72 bpm ตรงกับจังหวะที่เราขอไว้ในสไตล์ เพลง ACE Music v1.1 มาพร้อมโน้ตเพลงของตัวเอง และคัฟเวอร์กับแมชอัปของ v1.1 จะตามโน้ตเพลงนั้น ดูที่ คัฟเวอร์ รีมิกซ์ และการแก้ไข

แสดงการเรียก 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|

สคริปต์: stems-and-downloads/ ซึ่งบันทึกสเต็ม ไฟล์ดาวน์โหลดทุกรูปแบบ และโน้ตเพลง

ไลบรารีของคุณ

ทุกเพลงและทุกไฟล์ที่อัปโหลดในบัญชี ไม่ว่าจะสร้างที่นี่หรือบน acemusic.ai จะอยู่ในไลบรารีของบัญชีจนกว่าจะถูกลบ:

คำขอ หน้าที่
GET /music เพลงหนึ่งหน้า เรียงจากใหม่ไปเก่า พร้อม next สำหรับหน้าถัดไป ต้องส่ง email เมื่อมีมากกว่าหนึ่งบัญชี เพลงของงานที่เก่ากว่า 7 วันก็อยู่ที่นี่
GET /music/songId เพลงหนึ่งเพลงพร้อมลิงก์ใหม่ และสเต็มของเพลงถ้าเคยแยกไว้
DELETE /music/songId 204: เพลงถูกย้ายไปถังขยะของบัญชีบน acemusic.ai และหลังจากนั้น API จะตอบ 404 สำหรับเพลงนั้น
แสดงการเรียก 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"

สคริปต์: library/

ใช้หลายบัญชี ACE Music

การสมัครสมาชิก useapi.net แต่ละรายการเชื่อมบัญชี ACE Music ได้ 3 บัญชี รวมสูงสุด 100 บัญชี คำขอที่ไม่ระบุ email จะไปที่บัญชีที่ใช้งานได้ปกติและมีช่องว่าง ส่วนคำขอที่อ้างถึงเพลง ไฟล์อัปโหลด หรือภาพ จะทำงานบนบัญชีที่สิ่งนั้นอยู่ บัญชีหนึ่งรันคำขอพร้อมกันได้สูงสุด maxJobs รายการ ค่าเริ่มต้นคือ 4 ซึ่งเป็นขีดจำกัดของ ACE Music เอง เมื่อทุกบัญชีไม่ว่าง API จะตอบ 429 พร้อม Retry-After และถ้า ACE Music ปฏิเสธรหัสผ่าน บัญชีนั้นจะตอบ 596 จนกว่าคุณจะเพิ่มบัญชีอีกครั้ง

GET /accounts/email อ่านแพ็กเกจ เครดิต และอัตราเครดิตแบบเรียลไทม์ และ POST /accounts ที่ส่งแค่ email กับ maxJobs จะเปลี่ยนเฉพาะ maxJobs สคริปต์: accounts/

แสดงการเรียก 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 }'

ใช้จาก Claude, ChatGPT หรือ Cursor (MCP)

ฟีเจอร์ทั้งหมดนี้มีให้ใช้เป็น MCP server แบบโฮสต์ที่มี 15 เครื่องมือ ตั้งแต่เพลง คัฟเวอร์ และแมชอัป ไปจนถึงสเต็ม โน้ตเพลง และการอัปโหลด ACE Music ไม่มี MCP integration สาธารณะของตัวเอง (ข้อมูล ณ พฤศจิกายน 2026) ใน Claude Code ใช้คำสั่งเดียว:

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

Cursor, VS Code และ Windsurf ใช้ URL และ header เดียวกัน ส่วนแอป Claude และ ChatGPT ล็อกอินด้วย OAuth ดูที่ ใช้ในแอป Claude หรือ ChatGPT จากนั้นสั่งด้วยภาษาธรรมดาได้เลย เช่น “Write lyrics about a cat who loves rainy days and sing them as acoustic indie folk on ACE Music v1”

สร้างเป็นชุดด้วยสคริปต์

GitHub repo acemusic-api มีตัวอย่างหนึ่งชุดต่อหนึ่งฟีเจอร์ ซึ่งลิงก์ไว้จากแต่ละหัวข้อด้านบน แต่ละชุดมีสคริปต์ Node.js และสคริปต์ Python คู่กัน โดยไม่ต้องติดตั้งอะไรเพิ่ม แต่ละสคริปต์อ่านคำขอจาก prompts.json ที่คุณแก้ไขได้ รันพร้อมกันได้สูงสุด 4 รายการ โพลงาน แล้วบันทึกเพลงทั้งสองเพลง ภาพปก บันทึกงาน และ ledger.jsonl ของเครดิตที่ใช้ไว้ในโฟลเดอร์ output/

คุณต้องมี Node.js 21 ขึ้นไป หรือ Python 3.8 ขึ้นไป --only 3 จะรันพรอมต์ที่สามด้านล่าง ซึ่งเป็นเพลง ACE-Step ที่ไม่ใช้เครดิต จึงใช้กับบัญชี 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

บันทึกงานที่บันทึกไว้แต่ละไฟล์มี songId ของเพลง และ --from <job>.json --pick 1 จะส่งเพลงที่ 1 ต่อให้สคริปต์ถัดไปเพื่อคัฟเวอร์ แมชอัป หรือแยกสเต็ม

ขยาย 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"
    }
]

ตัวอย่าง

ทุกเพลงด้านล่างสร้างเมื่อวันที่ 14 พฤศจิกายน 2026 (PST) ด้วยสคริปต์ใน repo บนบัญชี ACE Music แพ็กเกจ Artist โดยเป็นเพลงแรกจากสองเพลงของแต่ละคำขอ ชื่อเพลงมาจาก ACE Music เว้นแต่เราตั้งเอง เวลานับตั้งแต่ส่งคำขอจนทั้งสองเพลงเสร็จ และการเรียก API ที่แสดงใช้ id สมมติ

เพลงจากภาพ

ส่งภาพหนึ่งภาพกับสไตล์หนึ่งประโยค ได้เพลงที่เสร็จแล้วสองเพลง เราอัปโหลดภาพมาสคอตหุ่นยนต์กำลังเต้นนี้แล้วขอเป็นดรัมแอนด์เบส ACE Music เขียนเนื้อเพลงจากสิ่งที่เห็นในภาพ: “Teal fur shaking on the concrete floor, orange high-tops squeaking by the studio door”

มาสคอตหุ่นยนต์ขนฟูสีเขียวอมฟ้า หัวเป็นกล่อง มีเสาอากาศและดวงตาเรืองแสง กำลังเต้นในรองเท้าผ้าใบหุ้มข้อสีส้ม

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 · สร้างใน 72 วินาที

แสดงการเรียก 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
  }'

เพลงจากพรอมต์

เพลง ACE Music v1 จากพรอมต์ “Let the 44 Roll By” อยู่ในส่วนสาธิตทีละขั้นตอนแล้ว ต่อไปนี้คืออีกสองพรอมต์บนอีกสองโมเดล:

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 · สร้างใน 43 วินาที

แสดงการเรียก 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, ไม่ใช้เครดิต — “Domingo em Alfama” · 3:28

แสดงการเรียก 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
  }'

เนื้อเพลงของคุณเอง

สองเวิร์ส พรีคอรัส บริดจ์ และเอาท์โทรที่เราเขียนเอง ขอความยาว 210 วินาที:

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 · สร้างใน 61 วินาที

แสดงการเรียก 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
  }'

เพลงบรรเลง: instrumental: true ยาว 150 วินาที ไม่มีเสียงร้อง คณะประสานเสียง หรือกีตาร์โปร่ง:

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 · สร้างใน 46 วินาที

แสดงการเรียก 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
  }'

เนื้อเพลงภาษาสเปนเกี่ยวกับปาร์ตี้บนดาดฟ้าระหว่างไฟดับ:

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 · สร้างใน 46 วินาที

แสดงการเรียก 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
  }'

เนื้อเพลงจากตัวช่วยเขียนเนื้อเพลง สไตล์จากตัวช่วยเขียนสไตล์ และร้องโดย ACE-Step:

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, ไม่ใช้เครดิต — “Side B Forever” · 3:35 · สร้างใน 40 วินาที หลังจากใช้ 6 วินาทีกับเนื้อเพลงและ 4 วินาทีกับสไตล์

แสดงการเรียก 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 ที่จังหวะ คีย์ และอัตราจังหวะที่กำหนด

ทุกเพลงได้ความยาวตรงตามที่ขอ

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, ไม่ใช้เครดิต — “Midnight Waltz” · 2:00 · สร้างใน 31 วินาที

แสดงการเรียก 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, ไม่ใช้เครดิต — “Harbour Jig” · 1:30 · สร้างใน 20 วินาที

แสดงการเรียก 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, ไม่ใช้เครดิต — “Almost Home” · 2:30 · สร้างใน 41 วินาที

แสดงการเรียก 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
  }'

คัฟเวอร์ รีมิกซ์ และการแก้ไข

“Paper Lanterns” ในแบบคัฟเวอร์ สไตล์ใหม่ที่ยังคงทำนองเดิม:

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 · สร้างใน 72 วินาที

แสดงการเรียก 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” ในแบบดีปเฮาส์ เราไม่ได้ส่งชื่อเพลง ACE Music จึงตั้งชื่อว่า “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, ไม่ใช้เครดิต — “Reference 1” · 2:32 · สร้างใน 31 วินาที

แสดงการเรียก 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” ที่เปลี่ยนเนื้อร้องช่วงวินาทีที่ 30 ถึง 50 และคงส่วนที่เหลือไว้:

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, ไม่ใช้เครดิต — “Reference 1” · 3:29 · สร้างใน 41 วินาที

แสดงการเรียก 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
  }'

แมชอัป

“Paper Lanterns” กับ “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 · สร้างใน 83 วินาที

แสดงการเรียก 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” กับ “Bailando en la Azotea” ที่ขอบน 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 (ขอเป็น v1) — “Harbor Fiesta” · 2:38 · สร้างใน 74 วินาที

แสดงการเรียก 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
  }'

สามเพลงพร้อมกัน: “Paper Lanterns”, “Bailando en la Azotea” และ “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 · สร้างใน 43 วินาที

แสดงการเรียก 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
  }'

ไฟล์เสียงและภาพของคุณ

“Harbour Jig” ด้านบน อัปโหลดเป็น MP3 แล้วใช้เป็นเพลงอ้างอิงของพรอมต์ ACE Music รันบน v1.1 เพื่อคงทำนองไว้:

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 (ขอเป็น v1) — “Last Ferry Home” · 1:36 · สร้างใน 52 วินาที

แสดงการเรียก 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
  }'

สเต็มของ “Paper Lanterns”

เสียงร้องและดนตรีจาก mode: "vocals" (5 เครดิต) ตามด้วยกลองและเครื่องสายจาก 9 สเต็มของ mode: "all" (60 เครดิต)

แสดงการเรียก 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
  }'

คำถามที่พบบ่อย

ACE Music มี API ไหม?
ผ่าน useapi.net มี ACE Music API รัน ACE Music v1, ACE Music v1.1 Preview และ ACE-Step v1.5 XL ผ่าน REST บนบัญชี ACE Music ของคุณ พร้อมคัฟเวอร์ แมชอัป สเต็ม และ MIDI ACE Music v1 และ v1.1 ไม่มี API สาธารณะของตัวเอง (ข้อมูล ณ พฤศจิกายน 2026) useapi.net จึงเป็นทางเดียวที่จะเรียกใช้โมเดลเหล่านี้จากโค้ด API ของ ACE Music เองรัน ACE-Step v1.5 รุ่นเก่ากว่า และหยุดรับสมัคร API key ใหม่ไว้แล้ว

มี ACE-Step API แบบฟรีไหม?
ผ่าน useapi.net มี เพลง ACE-Step v1.5 XL ไม่ใช้เครดิตในทุกแพ็กเกจ ACE Music รวมถึงแพ็กเกจ Free พร้อมการตั้งค่าจังหวะ คีย์ อัตราจังหวะ และความยาว รวมถึงรีมิกซ์และการแก้ไข ส่วน acestep.io ซึ่งเป็นบุคคลที่สาม ให้ใช้ ACE-Step API เฉพาะในแพ็กเกจ Studio $49 ต่อเดือน ราว $0.14 ต่อเพลง (ข้อมูล ณ พฤศจิกายน 2026)

เพลง ACE Music v1 ผ่าน API ราคาเท่าไร?
ผ่าน useapi.net เพลง ACE Music v1 หนึ่งเพลงใช้ 2 เครดิตจากแพ็กเกจ ACE Music ของคุณ คือ $0.013 บน Artist แบบชำระรายปี และ $0.023 บน Artist แบบรายเดือน โดยไม่มีค่าใช้จ่ายเพิ่มต่อเพลง ACE Music v1 ไม่มีขายผ่าน API สาธารณะใดเลย (ข้อมูล ณ พฤศจิกายน 2026) เครดิตในแพ็กเกจของคุณจึงเป็นทางเดียวที่จะจ่ายค่าเพลงทีละเพลงจากโค้ด ดูที่ราคา

ACE Music มี MCP server ไหม?
ผ่าน useapi.net มี ACE Music MCP server แบบโฮสต์ที่มี 15 เครื่องมือ ช่วยให้แอป Claude, ChatGPT, Claude Code และ Cursor สร้างเพลง คัฟเวอร์ แมชอัป และสเต็มบนบัญชี ACE Music ของคุณได้ โดยไม่ต้องติดตั้งอะไร ACE Music ไม่มี MCP integration สาธารณะของตัวเอง (ข้อมูล ณ พฤศจิกายน 2026)

สรุป

POST ครั้งเดียวได้เพลงสองเพลงจากโมเดลที่ครองอันดับหนึ่งของตารางอันดับเสียงร้อง เพลง ACE-Step ไม่มีค่าใช้จ่าย และทุกเพลงนำไปทำคัฟเวอร์ แมชอัป สเต็ม หรือไฟล์ MIDI ได้ในการเรียกครั้งถัดไป โคลน repo acemusic-api รัน songs-from-prompt/ ด้วย --only 3 บนบัญชี Free และดู POST /music สำหรับตัวเลือกทั้งหมด

ติดต่อเราได้ที่ Discord Server หรือ Telegram Channel สำหรับทุกคำถามและข้อสงสัยด้านการใช้งาน