เสียง
ACE-Step เครื่องมือสร้างเพลง
อธิบายสไตล์ ใส่เนื้อเพลง แล้วดาวน์โหลดเพลงพร้อมเสียงร้อง สร้างเพลงจากข้อความได้ฟรีบนอุปกรณ์ที่คุณเชื่อมต่อ
ACE-Step by ACE Studio and StepFun; Qwen3 Embedding by Alibaba Cloud
ใบอนุญาตโมเดล
ACE-Step v1.5 turbo DiT, lyric encoder and derived conditioning · MIT AND Apache-2.0
Retain MIT copyright/permission/disclaimer and applicable full Apache-2.0 terms, preserve upstream notices and identify modifications. Apache patent termination and trademark limitations apply.
ACE-Step v1.5 audio VAE decoder · MIT
Retain MIT copyright/permission/disclaimer, preserve upstream notices and identify modifications.
Qwen3 Embedding 0.6B text encoder and tokenizer · Apache-2.0
Retain full Apache-2.0 terms, preserve upstream notices and identify modifications. Apache patent termination and trademark limitations apply.
เอกสารอ้างอิง API
ส่งผ่าน REST
ใช้คีย์ API ส่วนบุคคลของคุณ (msk_…) เพื่อสร้างงานสำหรับเวิร์กโหลดนี้จากเครื่องมือของคุณเอง งานที่เริ่มด้วยวิธีนี้จะทำงานบนอุปกรณ์เดียวกับที่คุณเชื่อมต่อไว้ใน อุปกรณ์ของคุณ — ต้องมีอย่างน้อยหนึ่งเครื่องที่ออนไลน์
https://cp.meshlabs.cloud/v1/organizations/jobsยืนยันตัวตนด้วย X-Organization-Api-Key: msk_your_personal_api_key ชื่อเฮดเดอร์ตรงกับคีย์ขององค์กร ส่วนคีย์ส่วนบุคคลใช้ปลายทางเดียวกัน
เนื้อหาคำขอ
{
"workload_type": "ace-step-15-turbo-music",
"job_spec": {
"prompt": "A photorealistic lighthouse at dusk",
"vocalLanguage": "en",
"durationSec": 60,
"shift": 3
}
}ฟิลด์ของ job_spec
| ฟิลด์ | จำเป็น | ค่าเริ่มต้น | คำอธิบาย |
|---|---|---|---|
prompt | ใช่ | — | แนวเพลง เครื่องดนตรี อารมณ์ ลักษณะเสียงร้อง |
lyrics | ไม่ | — | ไม่บังคับ รองรับแท็กโครงสร้าง [verse] / [chorus] / [bridge] เว้นว่างไว้หากต้องการเพลงบรรเลง |
vocalLanguage | ไม่ | en | รหัสภาษาของเนื้อเพลง เช่น en, zh, ja, es ระบบจะไม่ใช้ค่านี้กับเพลงบรรเลง |
durationSec | ไม่ | 60 | ความยาวของเพลง หากงานไม่ได้ระบุช่องนี้ ระบบจะใช้ 60 วินาที |
shift | ไม่ | 3 | ตาราง timestep ค่า 3 เน้นความคมชัด ค่า 1 เน้นความตรงตามพรอมต์ |
seed | ไม่ | — | ไม่ระบุเพื่อให้ได้เพลงแบบสุ่ม ระบุค่าเพื่อสร้างเพลงเดิมซ้ำ |
bpm | ไม่ | — | ไม่ระบุเพื่อให้โมเดลเลือกเอง |
keyScale | ไม่ | — | เช่น C major หรือ A minor ไม่ระบุเพื่อให้โมเดลเลือกเอง |
timeSignature | ไม่ | — | จำนวนจังหวะต่อห้อง เช่น 4 สำหรับ 4/4 หรือ 3 สำหรับ 3/4 |
cURL
curl -X POST https://cp.meshlabs.cloud/v1/organizations/jobs \
-H "X-Organization-Api-Key: msk_your_personal_api_key" \
-H "Content-Type: application/json" \
-d '{
"workload_type": "ace-step-15-turbo-music",
"job_spec": {
"prompt": "A photorealistic lighthouse at dusk",
"vocalLanguage": "en",
"durationSec": 60,
"shift": 3
}
}'https://cp.meshlabs.cloud/v1/organizations/jobs/{job_id}โพลด้วยคีย์ API เดียวกันจนกว่า status จะเป็นสถานะสิ้นสุด (COMPLETED, FAILED, CANCELED หรือ MODERATION_BLOCKED) เมื่อเปิดใช้การกลั่นกรองเนื้อหา งานอาจเริ่มที่ MODERATION_PENDING ก่อนเข้าสู่คิวประมวลผล งานที่เสร็จสมบูรณ์จะมีค่า download_url ที่ลงนามล่วงหน้าในแต่ละเอาต์พุต
การตอบกลับเมื่อสร้าง
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"workload_type": "ace-step-15-turbo-music",
"status": "PENDING",
"job_spec_json": {
"prompt": "A photorealistic lighthouse at dusk",
"vocalLanguage": "en",
"durationSec": 60,
"shift": 3
},
"work_units": [],
"outputs": [],
"created_at": "2026-06-08T12:00:00Z",
"updated_at": "2026-06-08T12:00:00Z"
}การตอบกลับเมื่อเสร็จสมบูรณ์
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"workload_type": "ace-step-15-turbo-music",
"status": "COMPLETED",
"job_spec_json": {
"prompt": "A photorealistic lighthouse at dusk",
"vocalLanguage": "en",
"durationSec": 60,
"shift": 3
},
"work_units": [
{
"id": "…",
"index": 0,
"status": "COMPLETED"
}
],
"outputs": [
{
"id": "…",
"output_type": "<output type>",
"filename": "<output filename>",
"size_bytes": 524288,
"download_url": "<presigned output download URL>"
}
],
"created_at": "2026-06-08T12:00:00Z",
"updated_at": "<completion timestamp>"
}อธิบายสไตล์ ใส่เนื้อเพลงตามต้องการ แล้วดาวน์โหลดเพลงที่มีเสียงร้อง ความยาวสูงสุดราว 4 นาที เสียงสเตอริโอ สร้างเพลงจากข้อความได้ฟรีบนอุปกรณ์ที่คุณเชื่อมต่อ การใช้งานครั้งแรกจะดาวน์โหลดโมเดล เพลงถัดไปจะเริ่มได้เร็วขึ้น