الصوت

مولّد الموسيقى 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.

مجانيعبر الإنترنتبلا حدودACE-Step by ACE Studio and StepFun; Qwen3 Embedding by Alibaba Cloud الوصول عبر API

مرجع API

الإرسال عبر REST

استخدم مفتاح API الشخصي (msk_…) لإنشاء مهام لحمل العمل هذا من أدواتك. تعمل المهام التي تبدأ بهذه الطريقة على الأجهزة نفسها التي ربطتها في أجهزتك — يجب أن يكون أحدها على الأقل متصلًا.

إخفاء تفاصيل API
POSThttps://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
  }
}'
GEThttps://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>"
}

صف الأسلوب الموسيقي، وأضف كلمات اختيارية، ونزّل أغنية بصوت مغنٍّ، بمدة تصل إلى نحو أربع دقائق من الصوت الستيريو. تحويل النص إلى موسيقى مجانًا على الأجهزة التي تربطها. يُنزَّل النموذج في التشغيل الأول، وتبدأ الأغاني اللاحقة أسرع.