الصوت
مولّد الموسيقى 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 | جدول الخطوات الزمنية. القيمة 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>"
}صف الأسلوب الموسيقي، وأضف كلمات اختيارية، ونزّل أغنية بصوت مغنٍّ، بمدة تصل إلى نحو أربع دقائق من الصوت الستيريو. تحويل النص إلى موسيقى مجانًا على الأجهزة التي تربطها. يُنزَّل النموذج في التشغيل الأول، وتبدأ الأغاني اللاحقة أسرع.