دليل التكامل مع Producer Audios Generation API

ستقدم هذه المقالة دليلاً للتكامل مع Producer Audios Generation API، حيث يمكن من خلال إدخال معلمات مخصصة إنشاء موسيقى Producer الرسمية.

عملية التقديم

لاستخدام Producer Audios Generation API، انتقل أولاً إلى لوحة تحكم Ace Data Cloud للحصول على API Token الخاص بك، واحتفظ به للاستخدام لاحقاً.

إذا لم تكن قد سجلت الدخول أو أنشأت حساباً بعد، فسيتم تحويلك تلقائياً إلى صفحة تسجيل الدخول لدعوتك إلى التسجيل وتسجيل الدخول، وبعد الإكمال ستعود تلقائياً إلى الصفحة الحالية. يمكن لـ API Token واحد استدعاء جميع خدمات المنصة، ولا حاجة للتقديم بشكل منفصل لكل خدمة. عند التقديم لأول مرة، سيتم منحك رصيد مجاني للتجربة مجاناً؛ وعندما لا يكون الرصيد كافياً، يمكنك شحن الرصيد العام من لوحة التحكم.

📘 الوثائق الكاملة: Producer Audios Generation API →

الاستخدام الأساسي

أي نوع من الأغاني تريد، يمكنك إدخال أي نص بحرية، على سبيل المثال إذا أردت إنشاء أغنية عن عيد الميلاد، يمكنك إدخال a song for Christmas، كما هو موضح في الصورة:

يمكنك رؤية أننا قمنا هنا بتعيين Request Headers، وتشمل:

accept: تنسيق نتيجة الاستجابة التي تريد استقبالها، ويُملأ هنا بـ application/json، أي بتنسيق JSON.
authorization: مفتاح استدعاء API، وبعد التقديم يمكنك اختياره مباشرة من القائمة المنسدلة.

بالإضافة إلى ذلك، تتضمن معلمات Request Body ما يلي:

action: سلوك مهمة إنشاء الموسيقى هذه، وإنشاء الأغنية هو generate.
model: النموذج المستخدم لإنشاء الأغنية، وتشمل النماذج الرئيسية حالياً: FUZZ-2.0 Pro، FUZZ-2.0، FUZZ-2.0 Raw، FUZZ-1.1 Pro، FUZZ-1.0 Pro، FUZZ-1.0، FUZZ-1.1، FUZZ-0.8.
lyric: محتوى كلمات الأغنية.
custom: ما إذا كان سيتم إنشاء الأغنية بطريقة مخصصة.
prompt: الكلمات التوجيهية في وضع الإلهام.
title: معلومات عنوان الأغنية.
audio_id: معرّف الأغنية المرجعية، يُستخدم لعمليات مثل الاستكمال/إعادة الإصدار.
continue_at: بدء استكمال الأغنية من عدد الثواني المحدد.
replace_section_start/replace_section_end: وقتي بداية ونهاية المقطع المستبدل، بوحدة الثانية.
lyrics_strength: قوة الكلمات، وتمثل مدى تأثير الكلمات في إنشاء الصوت، ويمكن اختيار قيمة بين 0 و1، والقيمة الافتراضية هي 0.7.
sound_strength: قوة الكلمات التوجيهية الصوتية، ويمكن اختيار قيمة بين 0.2 و1، والقيمة الافتراضية هي 0.7.
cover_strength: قوة الغناء المعاد، بين 0.2 و1، والقيمة الافتراضية هي 1.
weirdness: درجة غرابة الأسلوب، ويمكن اختيار قيمة بين 0 و1، والقيمة الافتراضية هي 0.5.
callback_url: عنوان URL الذي يحتاج إلى استدعاء النتيجة.
async: اختياري، عند تعيينه إلى true ستعيد الواجهة task_id فوراً، دون الحاجة إلى توفير callback_url، ثم يتم الحصول على النتيجة عن طريق الاستعلام الدوري من خلال واجهة الاستعلام عن المهمة المقابلة.
instrumental: ما إذا كان في وضع دون كلمات.

بعد الاختيار، يمكنك ملاحظة أنه تم أيضاً إنشاء الكود المقابل على الجانب الأيمن، كما هو موضح في الصورة:

انقر فوق زر «Try» لإجراء الاختبار، كما هو موضح في الصورة أعلاه، وهنا حصلنا على النتيجة التالية:

{
  "success": true,
  "task_id": "82fd443a-903a-4f18-8028-12d2f8a0a4be",
  "trace_id": "d85839fa-0bb1-42da-a9fc-cd582c29027d",
  "data": [
    {
      "id": "6c947f13-a3c5-4b9c-8609-5639c37cdc2d",
      "title": "Untitled",
      "image_url": "https://cdn.acedata.cloud/e724d7f13d.png",
      "lyric": "[Instrumental]",
      "audio_url": "https://cdn.acedata.cloud/assets/examples/fish/5ade0339-5f11-487e-aacc-06a908271706-8e3fcb0e5547.mp3",
      "video_url": null,
      "image_id": "6c947f13-a3c5-4b9c-8609-5639c37cdc2d",
      "topic": null,
      "seed": "2450882164",
      "sound": "A song for Christmas",
      "created_at": "2025-12-30T17:18:23.232911Z",
      "model": "FUZZ-2.0 Pro",
      "progress": "100%",
      "state": "succeeded",
      "duration": "181.3014058956916"
    }
  ]
}

تتضمن النتيجة المعادة عدة حقول، وفيما يلي تعريفها:

success، حالة مهمة إنشاء الموسيقى في هذه اللحظة.
- data، نتيجة مهمة الموسيقى هذه.
  - id، معرّف مهمة إنشاء الموسيقى في هذه اللحظة.
  - sound، الكلمات التوجيهية لمهمة إنشاء الموسيقى في هذه اللحظة.
  - seed، قيمة البذرة لمهمة إنشاء الموسيقى في هذه اللحظة.
  - audio_url، رابط الصوت لمهمة إنشاء الموسيقى في هذه اللحظة.
  - image_url، رابط الغلاف لمهمة إنشاء الموسيقى في هذه اللحظة.
  - image_id، معرّف غلاف مهمة إنشاء الموسيقى في هذه اللحظة.
  - state، حالة مهمة إنشاء الموسيقى في هذه اللحظة.
  - duration، معلومات مدة الموسيقى في هذه اللحظة.
  - progress، قيمة تقدم مهمة الموسيقى في هذه اللحظة.
  - model، معلومات النموذج المستخدم في مهمة إنشاء الموسيقى في هذه اللحظة.
  - lyric، معلومات كلمات مهمة إنشاء الموسيقى في هذه اللحظة.

يمكنك رؤية أننا حصلنا على معلومات الموسيقى التي نريد إنشاءها، ونحتاج فقط إلى الحصول على موسيقى Producer المُنشأة وفقاً لعنوان رابط الموسيقى ضمن data في النتيجة. بالإضافة إلى ذلك، إذا أردت إنشاء كود التكامل المقابل، يمكنك نسخه مباشرة، على سبيل المثال كود CURL كما يلي:

curl -X POST 'https://api.acedata.cloud/producer/audios' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "action": "generate",
  "model": "FUZZ-2.0 Pro",
  "prompt": "A song for Christmas"
}'

الإنشاء المخصص

إذا أردت إنشاء كلمات مخصصة، يمكنك إدخال الكلمات: عندها يمكن تمرير محتوى مشابه لما يلي في حقل lyric:

[Verse]Woke up with the sun in my eyesNo clouds above just blue in the skiesShoes on my feet I’m ready to runEvery step feels like a loaded gun[Chorus]Happy days are rolling inLet the joy beneath my skinNo more shadows no more liesJust the truth that lifts me high[Verse 2]Dancing through the city streetsA rhythm pounding in my heartbeatStrangers smile it’s catching onThis world’s a stage we’re all a song[Chorus]Happy days are rolling inLet the joy beneath my skinNo more shadows no more liesJust the truth that lifts me high[Bridge]Throw your worries out the doorLet them sink to the ocean floorWe’re alive and it’s enoughLife is messy but it’s love[Chorus]Happy days are rolling inLet the joy beneath my skinNo more shadows no more liesJust the truth that lifts me high

بعد ذلك، إذا أردنا إنشاء أغنية مخصصة وفقاً للكلمات والعنوان والأسلوب، فيمكننا تحديد المحتوى التالي:

lyric: نص كلمات الأغنية
custom: املأه بـ true، مما يعني إنشاءً مخصصًا، والقيمة الافتراضية لهذه المعلمة هي false، مما يعني الإنشاء باستخدام prompt.
title: عنوان الأغنية.

مثال على التعبئة كما يلي:

بعد إكمال التعبئة، تم إنشاء الكود التالي تلقائيًا:

الكود المقابل:

curl -X POST 'https://api.acedata.cloud/producer/audios' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "action": "generate",
  "model": "FUZZ-2.0 Pro",
  "instrumental": false,
  "lyric": "[Verse]\nWoke up with the sun in my eyes\nNo clouds above just blue in the skies\nShoes on my feet I’m ready to run\nEvery step feels like a loaded gun\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high\n[Verse 2]\nDancing through the city streets\nA rhythm pounding in my heartbeat\nStrangers smile it’s catching on\nThis world’s a stage we’re all a song\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high\n[Bridge]\nThrow your worries out the door\nLet them sink to the ocean floor\nWe’re alive and it’s enough\nLife is messy but it’s love\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high",
  "custom": true
}'

تم السماح بالاختبار، وكانت النتيجة المُنشأة مشابهة.

{
  "success": true,
  "task_id": "9f58bbd4-855a-4233-ac45-b63bf9168e02",
  "trace_id": "145ad117-6ce7-42dd-af12-70751c5284fc",
  "data": [
    {
      "id": "38d3b9e2-0dfb-4338-b2a7-15e45656ed32",
      "title": "Woke up with the sun in my eyes",
      "image_url": "https://cdn.acedata.cloud/e724d7f13d.png",
      "lyric": "[Verse]\nWoke up with the sun in my eyes\nNo clouds above just blue in the skies\nShoes on my feet I’m ready to run\nEvery step feels like a loaded gun\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high\n[Verse 2]\nDancing through the city streets\nA rhythm pounding in my heartbeat\nStrangers smile it’s catching on\nThis world’s a stage we’re all a song\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high\n[Bridge]\nThrow your worries out the door\nLet them sink to the ocean floor\nWe’re alive and it’s enough\nLife is messy but it’s love\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high",
      "audio_url": "https://cdn.acedata.cloud/assets/examples/fish/5ade0339-5f11-487e-aacc-06a908271706-8e3fcb0e5547.mp3",
      "video_url": null,
      "image_id": "38d3b9e2-0dfb-4338-b2a7-15e45656ed32",
      "topic": null,
      "seed": "3789209121",
      "sound": "",
      "created_at": "2025-12-30T17:26:46.357055Z",
      "model": "FUZZ-2.0 Pro",
      "progress": "100%",
      "state": "succeeded",
      "duration": "153.80897959183673"
    }
  ]
}

إعادة غناء الأغنية

إذا كنت ترغب في إجراء عملية إعادة غناء على أغنية تم إنشاؤها بالفعل، يمكنك إدخال الأغنية المُنشأة أعلاه لإعادة غنائها، وبعد ذلك سنُنشئ أغنية مخصصة بناءً على كلمات الأغنية والعنوان. إذا كنت ترغب في متابعة إعادة غناء أغنية قمت برفعها بنفسك، يمكنك تعيين المعلمة action إلى upload_cover، وإدخال معرّف الأغنية المرفوعة المخصصة التي تحتاج إلى متابعة إعادة غنائها. يتم الحصول على معرّف الأغنية باستخدام Producer Upload API، كما هو موضح في الصورة التالية:

يمكنك حينها تحديد المحتوى التالي:

action: سلوك مهمة الأغنية هذه، ويدعم حاليًا: generate، cover، extend، upload_cover، upload_extend، replace_section، swap_vocals، swap_instrumentals، variation، وتستخدم إعادة الغناء هذه المعلمة cover.
lyric: نص كلمات الأغنية
title: عنوان الأغنية.
custom: ما إذا كان سيتم الإنشاء باستخدام الوضع المخصص، والقيمة الافتراضية هي false.
audio_id: معرّف الأغنية التي تحتاج إلى إعادة غنائها.

مثال على التعبئة كما يلي:

بعد إكمال التعبئة، تم إنشاء الكود التالي تلقائيًا:

الكود المقابل:

curl -X POST 'https://api.acedata.cloud/producer/audios' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "action": "cover",
  "model": "FUZZ-2.0 Pro",
  "lyric": "[Verse]\nWoke up with the sun in my eyes\nNo clouds above just blue in the skies\nShoes on my feet I’m ready to run\nEvery step feels like a loaded gun\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high\n[Verse 2]\nDancing through the city streets\nA rhythm pounding in my heartbeat\nStrangers smile it’s catching on\nThis world’s a stage we’re all a song\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high\n[Bridge]\nThrow your worries out the door\nLet them sink to the ocean floor\nWe’re alive and it’s enough\nLife is messy but it’s love\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high",
  "audio_id": "38d3b9e2-0dfb-4338-b2a7-15e45656ed32",
  "instrumental": false,
  "custom": true,
  "title": "Cover"
}'

تم السماح بالاختبار، وكانت النتيجة المُنشأة مشابهة.

{
  "success": true,
  "task_id": "dbca350e-6fb9-46ca-9c7e-4c1a9080806f",
  "trace_id": "a39e0fff-ced8-4b31-ae23-aef3badd90fa",
  "data": [
    {
      "id": "e52dd729-38b4-4c2f-9031-59eb7953c593",
      "title": "Cover",
      "image_url": "https://cdn.acedata.cloud/e724d7f13d.png",
      "lyric": "[Verse]\nWoke up with the sun in my eyes\nNo clouds above just blue in the skies\nShoes on my feet I’m ready to run\nEvery step feels like a loaded gun\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high\n[Verse 2]\nDancing through the city streets\nA rhythm pounding in my heartbeat\nStrangers smile it’s catching on\nThis world’s a stage we’re all a song\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high\n[Bridge]\nThrow your worries out the door\nLet them sink to the ocean floor\nWe’re alive and it’s enough\nLife is messy but it’s love\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high",
      "audio_url": "https://cdn.acedata.cloud/assets/examples/fish/5ade0339-5f11-487e-aacc-06a908271706-8e3fcb0e5547.mp3",
      "video_url": null,
      "image_id": "e52dd729-38b4-4c2f-9031-59eb7953c593",
      "topic": null,
      "seed": "358803418",
      "sound": "",
      "created_at": "2025-12-30T17:32:32.951948Z",
      "model": "FUZZ-2.0 Pro",
      "progress": "100%",
      "state": "succeeded",
      "duration": "153.0659410430839"
    }
  ]
}

متابعة كتابة الأغنية

إذا أردت متابعة كتابة أغنية، نحتاج إلى تمرير قيمة المعلمة action كالتالي: extend، وبعد ذلك يمكننا تخصيص إنشاء أغنية بناءً على الكلمات والعنوان والأسلوب. إذا أردت متابعة كتابة أغنية قمت برفعها بنفسك، فيمكنك تعيين المعلمة action إلى upload_extend، وإدخال معرّف الأغنية المخصصة التي تم رفعها والتي تحتاج إلى متابعة كتابتها. يتم الحصول على معرّف الأغنية باستخدام Producer Upload API، كما هو موضح في الصورة أدناه:

مثال على التعبئة كما يلي:

بعد إكمال التعبئة، يتم إنشاء الكود التالي تلقائيًا:

الكود المقابل:

curl -X POST 'https://api.acedata.cloud/producer/audios' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "action": "extend",
  "model": "FUZZ-2.0 Pro",
  "instrumental": false,
  "lyric": "[Verse]\nWoke up with the sun in my eyes\nNo clouds above just blue in the skies\nShoes on my feet I’m ready to run\nEvery step feels like a loaded gun\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high\n[Verse 2]\nDancing through the city streets\nA rhythm pounding in my heartbeat\nStrangers smile it’s catching on\nThis world’s a stage we’re all a song\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high\n[Bridge]\nThrow your worries out the door\nLet them sink to the ocean floor\nWe’re alive and it’s enough\nLife is messy but it’s love\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high",
  "continue_at": 3,
  "audio_id": "38d3b9e2-0dfb-4338-b2a7-15e45656ed32",
  "custom": true,
  "title": "Extend",
  "weirdness": 0.3,
  "sound_strength": 0.3,
  "lyrics_strength": 0.6
}'

تم السماح بالاختبار، والنتيجة المُولَّدة مشابهة.

{
  "success": true,
  "task_id": "834983cb-d62d-4750-b1aa-461da137e51f",
  "trace_id": "6923eee2-7403-432c-8bd1-e471086385b0",
  "data": [
    {
      "id": "d9ebc609-fb65-4a23-b914-c074747af6a4",
      "title": "Extend",
      "image_url": "https://cdn.acedata.cloud/e724d7f13d.png",
      "lyric": "[Verse]\n[Verse]\nWoke up with the sun in my eyes\nNo clouds above just blue in the skies\nShoes on my feet I’m ready to run\nEvery step feels like a loaded gun\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high\n[Verse 2]\nDancing through the city streets\nA rhythm pounding in my heartbeat\nStrangers smile it’s catching on\nThis world’s a stage we’re all a song\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high\n[Bridge]\nThrow your worries out the door\nLet them sink to the ocean floor\nWe’re alive and it’s enough\nLife is messy but it’s love\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high",
      "audio_url": "https://cdn.acedata.cloud/assets/examples/fish/5ade0339-5f11-487e-aacc-06a908271706-8e3fcb0e5547.mp3",
      "video_url": null,
      "image_id": "d9ebc609-fb65-4a23-b914-c074747af6a4",
      "topic": null,
      "seed": "4294469624",
      "sound": "",
      "created_at": "2025-12-30T17:36:14.520928Z",
      "model": "FUZZ-2.0 Pro",
      "progress": "100%",
      "state": "succeeded",
      "duration": "173.87102040816328"
    }
  ]
}

تحويل الموسيقى

إذا أردت إنشاء موسيقى جديدة ذات تأثير مشابه بناءً على قيمة seed للموسيقى السابقة، نحتاج إلى تمرير قيمة المعلمة action كالتالي: variation، وبعد ذلك يمكن تخصيص إنشاء موسيقى جديدة ذات تأثير مشابه. مثال على التعبئة كما يلي:

بعد إكمال التعبئة، يتم إنشاء الكود التالي تلقائيًا:

الكود المقابل:

curl -X POST 'https://api.acedata.cloud/producer/audios' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "action": "variation",
  "audio_id": "d9ebc609-fb65-4a23-b914-c074747af6a4",
  "model": "FUZZ-2.0 Pro",
  "instrumental": false,
  "lyric": "[Verse]\nWoke up with the sun in my eyes\nNo clouds above just blue in the skies\nShoes on my feet I’m ready to run\nEvery step feels like a loaded gun\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high\n[Verse 2]\nDancing through the city streets\nA rhythm pounding in my heartbeat\nStrangers smile it’s catching on\nThis world’s a stage we’re all a song\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high\n[Bridge]\nThrow your worries out the door\nLet them sink to the ocean floor\nWe’re alive and it’s enough\nLife is messy but it’s love\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high",
  "custom": true
}'

يُسمح بالاختبار، والتأثير المُولَّد مشابه.

{
    "success": true,
    "task_id": "3a74da6d-a37d-4b5d-b116-821f455bce39",
    "trace_id": "8e28cce0-0400-4bfd-83db-6d27f97422c7",
    "data": [
        {
            "id": "c14ca458-cd5a-4700-83d4-5249e15f2707",
            "title": "Woke up with the sun in my eyes",
            "image_url": "https://cdn.acedata.cloud/e724d7f13d.png",
            "lyric": "[Verse]\nWoke up with the sun in my eyes\nNo clouds above just blue in the skies\nShoes on my feet I’m ready to run\nEvery step feels like a loaded gun\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high\n[Verse 2]\nDancing through the city streets\nA rhythm pounding in my heartbeat\nStrangers smile it’s catching on\nThis world’s a stage we’re all a song\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high\n[Bridge]\nThrow your worries out the door\nLet them sink to the ocean floor\nWe’re alive and it’s enough\nLife is messy but it’s love\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high",
            "audio_url": "https://cdn.acedata.cloud/assets/examples/fish/5ade0339-5f11-487e-aacc-06a908271706-8e3fcb0e5547.mp3",
            "video_url": null,
            "image_id": "c14ca458-cd5a-4700-83d4-5249e15f2707",
            "topic": null,
            "seed": "2082104582",
            "sound": "",
            "created_at": "2025-12-30T17:48:40.135187Z",
            "model": "FUZZ-2.0",
            "progress": "100%",
            "state": "succeeded",
            "duration": "173.12798185941043"
        }
    ]
}

استبدال المقطع

إذا كنت ترغب في استبدال مقطع من الأغنية، نحتاج إلى تمرير قيمة المعلمة action على النحو التالي: replace_section، وبعد ذلك سنُنشئ أغنية مخصصة بناءً على كلمات الأغنية والعنوان. إذا كنت ترغب في الاستمرار في استبدال مقطع من أغنية قمت برفعها بنفسك، يمكنك تعيين المعلمة action إلى upload_replace_section، وإدخال معرّف الأغنية المخصصة التي تم رفعها والتي تحتاج إلى مواصلة الكتابة لها. يتم الحصول على معرّف الأغنية باستخدام Producer Upload API، كما هو موضح في الصورة أدناه:

مثال على التعبئة كما يلي:

بعد إكمال التعبئة، يتم إنشاء الكود التالي تلقائيًا:

الكود المقابل:

curl -X POST 'https://api.acedata.cloud/producer/audios' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "action": "replace_section",
  "model": "FUZZ-2.0 Pro",
  "instrumental": false,
  "lyric": "[Verse]\\nWoke up with the sun in my eyes\\nNo clouds above just blue in the skies\\nShoes on my feet I’m ready to run\\nEvery step feels like a loaded gun\\n[Chorus]\\nHappy days are rolling in\\nLet the joy beneath my skin\\nNo more shadows no more lies\\nJust the truth that lifts me high\\n[Verse 2]\\nDancing through the city streets\\nA rhythm pounding in my heartbeat\\nStrangers smile it’s catching on\\nThis world’s a stage we’re all a song\\n[Chorus]\\nHappy days are rolling in\\nLet the joy beneath my skin\\nNo more shadows no more lies\\nJust the truth that lifts me high\\n[Bridge]\\nThrow your worries out the door\\nLet them sink to the ocean floor\\nWe’re alive and it’s enough\\nLife is messy but it’s love\\n[Chorus]\\nHappy days are rolling in\\nLet the joy beneath my skin\\nNo more shadows no more lies\\nJust the truth that lifts me high",
  "audio_id": "d9ebc609-fb65-4a23-b914-c074747af6a4",
  "replace_section_start": 3,
  "replace_section_end": 70,
  "custom": true
}'

يُسمح بالاختبار، والتأثير المُولَّد مشابه.

{
    "success": true,
    "task_id": "3cb5ae96-01b0-4a37-afb0-e582608af56f",
    "trace_id": "3ebc6f63-5093-4499-bf9b-95c239e0da4f",
    "data": [
        {
            "id": "a54609c6-13e2-4176-be0f-4d7eebc68e1f",
            "title": "Woke up with the sun in my eyes",
            "image_url": "https://cdn.acedata.cloud/e724d7f13d.png",
            "lyric": "[Verse]\\nWoke up with the sun in my eyes\\nNo clouds above just blue in the skies\\nShoes on my feet I’m ready to run\\nEvery step feels like a loaded gun\\n[Chorus]\\nHappy days are rolling in\\nLet the joy beneath my skin\\nNo more shadows no more lies\\nJust the truth that lifts me high\\n[Verse 2]\\nDancing through the city streets\\nA rhythm pounding in my heartbeat\\nStrangers smile it’s catching on\\nThis world’s a stage we’re all a song\\n[Chorus]\\nHappy days are rolling in\\nLet the joy beneath my skin\\nNo more shadows no more lies\\nJust the truth that lifts me high\\n[Bridge]\\nThrow your worries out the door\\nLet them sink to the ocean floor\\nWe’re alive and it’s enough\\nLife is messy but it’s love\\n[Chorus]\\nHappy days are rolling in\\nLet the joy beneath my skin\\nNo more shadows no more lies\\nJust the truth that lifts me high",
            "audio_url": "https://cdn.acedata.cloud/assets/examples/fish/5ade0339-5f11-487e-aacc-06a908271706-8e3fcb0e5547.mp3",
            "video_url": null,
            "image_id": "a54609c6-13e2-4176-be0f-4d7eebc68e1f",
            "topic": null,
            "seed": "14887454",
            "sound": "",
            "created_at": "2025-12-30T18:01:19.907443Z",
            "model": "FUZZ-2.0 Pro",
            "progress": "100%",
            "state": "succeeded",
            "duration": "174.6140589569161"
        }
    ]
}

إعادة إصدار المرافقة الموسيقية

إذا كنت ترغب في استخدام عملية إعادة إصدار المرافقة الموسيقية الرسمية، يمكنك تعيين قيمة المعلمة action إلى: swap_instrumentals، بعد ذلك سنقوم بإنشاء أغنية مخصصة بناءً على كلمات الأغنية والعنوان. مثال على التعبئة كما يلي:

بعد إكمال التعبئة، يتم إنشاء الكود تلقائيًا كما يلي:

الكود المقابل:

curl -X POST 'https://api.acedata.cloud/producer/audios' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "action": "swap_instrumentals",
  "model": "FUZZ-2.0 Pro",
  "weirdness": 0.6,
  "prompt": "Happy",
  "audio_id": "d9ebc609-fb65-4a23-b914-c074747af6a4"
}'

الاختبار مسموح به، والتأثير الناتج مشابه.

{
  "success": true,
  "task_id": "d17d8376-3a58-451d-a976-404719bac11d",
  "trace_id": "ab596807-910a-4e30-bae2-4647895f7d0b",
  "data": [
    {
      "id": "22d7d75c-9e0a-47a8-b22b-eea55eaa0c4b",
      "title": "Extend (Sound swap)",
      "image_url": "https://cdn.acedata.cloud/e724d7f13d.png",
      "lyric": "[Verse]\nWoke up with the sun in my eyes\nNo clouds above just blue in the skies\nShoes on my feet I’m ready to run\nEvery step feels like a loaded gun\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high\n[Verse 2]\nDancing through the city streets\nA rhythm pounding in my heartbeat\nStrangers smile it’s catching on\nThis world’s a stage we’re all a song\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high\n[Bridge]\nThrow your worries out the door\nLet them sink to the ocean floor\nWe’re alive and it’s enough\nLife is messy but it’s love\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high",
      "audio_url": "https://cdn.acedata.cloud/assets/examples/fish/5ade0339-5f11-487e-aacc-06a908271706-8e3fcb0e5547.mp3",
      "video_url": null,
      "image_id": "22d7d75c-9e0a-47a8-b22b-eea55eaa0c4b",
      "topic": null,
      "seed": "2157878068",
      "sound": "Happy",
      "created_at": "2025-12-30T18:09:49.594800Z",
      "model": "FUZZ-2.0 Pro",
      "progress": "100%",
      "state": "succeeded",
      "duration": "172.3849433106576"
    }
  ]
}

إعادة إصدار الصوت البشري

إذا كنت ترغب في استخدام عملية إعادة إصدار الصوت البشري الرسمية، يمكنك تعيين قيمة المعلمة action إلى: swap_vocals، بعد ذلك سنقوم بإنشاء أغنية مخصصة بناءً على كلمات الأغنية والعنوان والنمط. مثال على التعبئة كما يلي:

بعد إكمال التعبئة، يتم إنشاء الكود تلقائيًا كما يلي:

الكود المقابل:

curl -X POST 'https://api.acedata.cloud/producer/audios' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "action": "swap_vocals",
  "model": "FUZZ-2.0 Pro",
  "instrumental": false,
  "lyric": "[Verse]\nWoke up with the sun in my eyes\nNo clouds above just blue in the skies\nShoes on my feet I’m ready to run\nEvery step feels like a loaded gun\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high\n[Verse 2]\nDancing through the city streets\nA rhythm pounding in my heartbeat\nStrangers smile it’s catching on\nThis world’s a stage we’re all a song\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high\n[Bridge]\nThrow your worries out the door\nLet them sink to the ocean floor\nWe’re alive and it’s enough\nLife is messy but it’s love\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high",
  "weirdness": 0.6,
  "lyrics_strength": 0.8,
  "audio_id": "d9ebc609-fb65-4a23-b914-c074747af6a4",
  "custom": true
}'

الاختبار مسموح به، والتأثير الناتج مشابه.

{
  "success": true,
  "task_id": "a903ac38-f129-4f85-9181-b1dc5579bd32",
  "trace_id": "9953af52-45e0-4808-bf13-88f0b21262c1",
  "data": [
    {
      "id": "7b2d653b-aaaa-41b0-b737-aee4c4c5693b",
      "title": "Woke up with the sun in my eyes",
      "image_url": "https://cdn.acedata.cloud/e724d7f13d.png",
      "lyric": "[Verse]\nWoke up with the sun in my eyes\nNo clouds above just blue in the skies\nShoes on my feet I’m ready to run\nEvery step feels like a loaded gun\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high\n[Verse 2]\nDancing through the city streets\nA rhythm pounding in my heartbeat\nStrangers smile it’s catching on\nThis world’s a stage we’re all a song\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high\n[Bridge]\nThrow your worries out the door\nLet them sink to the ocean floor\nWe’re alive and it’s enough\nLife is messy but it’s love\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high",
      "audio_url": "https://cdn.acedata.cloud/assets/examples/fish/5ade0339-5f11-487e-aacc-06a908271706-8e3fcb0e5547.mp3",
      "video_url": null,
      "image_id": "7b2d653b-aaaa-41b0-b737-aee4c4c5693b",
      "topic": null,
      "seed": "2484735707",
      "sound": "",
      "created_at": "2025-12-30T18:13:01.349875Z",
      "model": "FUZZ-2.0 Pro",
      "progress": "100%",
      "state": "succeeded",
      "duration": "173.12798185941043"
    }
  ]
}

فصل الكلمات والموسيقى

إذا أردت استخدام عملية فصل الكلمات والموسيقى الرسمية، يمكنك تعيين قيمة معامل action إلى: stems، وبعد ذلك نحتاج إلى فصل الكلمات والموسيقى بناءً على معرّف الأغنية. مثال التعبئة كما يلي:

بعد إكمال التعبئة، يتم إنشاء الكود تلقائيًا كما يلي:

الكود المقابل:

curl -X POST 'https://api.acedata.cloud/producer/audios' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "action": "stems",
  "audio_id": "a54609c6-13e2-4176-be0f-4d7eebc68e1f"
}'

يُسمح بالاختبار، والتأثير المُنشأ مماثل.

{
    "success": true,
    "task_id": "561ac695-b4aa-47cf-978d-fb7be2b9ebfc",
    "trace_id": "66d0d397-2987-4bde-84fb-a60d0023b217",
    "data": [
        {
            "title": "Woke up with the sun in my eyes",
            "lyric": "",
            "stems_url": "https://platform.cdn.acedata.cloud/producer/561ac695-b4aa-47cf-978d-fb7be2b9ebfc.zip",
            "model": "",
            "progress": "100%",
            "state": "succeeded"
        }
    ]
}

الاستدعاء غير المتزامن

نظرًا إلى أن وقت التوليد الخاص بـ Producer Audios Generation API قد يكون طويلًا نسبيًا في بعض الأحيان، فإذا لم تستجب API لفترة طويلة، فسيبقى طلب HTTP متصلًا باستمرار، مما يؤدي إلى استهلاك موارد إضافية للنظام، لذلك توفر هذه API أيضًا دعمًا للاستدعاء غير المتزامن. التدفق العام هو: عندما يبدأ العميل طلبًا، يحدد بالإضافة إلى ذلك حقل callback_url، وبعد أن يبدأ العميل طلب API، ستعيد API فورًا نتيجةً تحتوي على معلومات الحقل task_id، والذي يمثل معرّف المهمة الحالية. عند اكتمال المهمة، سيتم إرسال نتيجة مهمة التوليد إلى callback_url الذي حدده العميل بصيغة POST JSON، والتي تتضمن أيضًا حقل task_id، وبهذه الطريقة يمكن ربط نتيجة المهمة عبر المعرّف. فيما يلي، سنتعرف من خلال مثال على كيفية التشغيل بالتحديد. أولًا، استدعاء Webhook هو خدمة يمكنها استقبال طلبات HTTP، وينبغي للمطورين استبداله بعنوان URL لخادم HTTP الذي أنشؤوه بأنفسهم. هنا، لتسهيل العرض، نستخدم موقع نموذج Webhook عامًا https://webhook.site/، ويمكن الحصول على عنوان URL لـ Webhook بمجرد فتح هذا الموقع، كما هو موضح في الصورة:

انسخ عنوان URL هذا، ويمكن استخدامه كـ Webhook، والمثال هنا هو https://webhook.site/#!/view/0d73431d-f833-4be4-9276-b6e1690d55c1. بعد ذلك، يمكننا تعيين الحقل callback_url إلى عنوان URL الخاص بـ Webhook أعلاه، مع إدخال المعاملات المقابلة في الوقت نفسه، والمحتوى المحدد كما هو موضح في الصورة:

انقر فوق تشغيل، ويمكن ملاحظة أنه سيتم الحصول على نتيجة فورًا، كما يلي:

{
  "task_id": "1a6ac2ad-10f2-4e2b-b500-66ec27fe82ad"
}

انتظر قليلًا، ويمكننا ملاحظة نتيجة مهمة التوليد على https://webhook.site/#!/view/0d73431d-f833-4be4-9276-b6e1690d55c1، كما هو موضح في الصورة:

المحتوى كما يلي:

{
    "success": true,
    "task_id": "1a6ac2ad-10f2-4e2b-b500-66ec27fe82ad",
    "trace_id": "1da03537-4eb8-410d-b849-43f03085a3bb",
    "data": [
        {
            "id": "1dd08826-478e-43a6-868f-aff5ababac2c",
            "title": "Woke up with the sun in my eyes",
            "image_url": "https://cdn.acedata.cloud/e724d7f13d.png",
            "lyric": "[Verse]\nWoke up with the sun in my eyes\nNo clouds above just blue in the skies\nShoes on my feet I’m ready to run\nEvery step feels like a loaded gun\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high\n[Verse 2]\nDancing through the city streets\nA rhythm pounding in my heartbeat\nStrangers smile it’s catching on\nThis world’s a stage we’re all a song\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high\n[Bridge]\nThrow your worries out the door\nLet them sink to the ocean floor\nWe’re alive and it’s enough\nLife is messy but it’s love\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high",
            "audio_url": "https://cdn.acedata.cloud/assets/examples/fish/5ade0339-5f11-487e-aacc-06a908271706-8e3fcb0e5547.mp3",
            "video_url": null,
            "image_id": "1dd08826-478e-43a6-868f-aff5ababac2c",
            "topic": null,
            "seed": "1490770667",
            "sound": "",
            "created_at": "2025-12-30T18:36:00.994141Z",
            "model": "FUZZ-2.0 Pro",
            "progress": "100%",
            "state": "succeeded",
            "duration": "135.2330158730159"
        }
    ]
}

يمكن ملاحظة وجود حقل task_id في النتيجة، وتتشابه الحقول الأخرى مع ما ورد أعلاه، ويمكن تحقيق ربط المهام من خلال هذا الحقل.

معالجة الأخطاء

عند استدعاء API، إذا واجهت خطأً، فسيُرجع API رمز الخطأ والمعلومات المقابلة. على سبيل المثال:

400 token_mismatched：طلب غير صالح، ربما بسبب معلمات مفقودة أو غير صالحة.
400 api_not_implemented：طلب غير صالح، ربما بسبب معلمات مفقودة أو غير صالحة.
401 invalid_token：غير مصرح به، رمز تفويض غير صالح أو مفقود.
429 too_many_requests：طلبات كثيرة جدًا، لقد تجاوزت حد المعدل.
500 api_error：خطأ داخلي في الخادم، حدث خطأ ما على الخادم.

مثال على استجابة خطأ

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "fetch failed"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

الخلاصة

من خلال هذه الوثيقة، تعرفت بالفعل على كيفية استخدام Producer Audios Generation API لإنشاء الموسيقى عبر إدخال كلمات توجيهية. نأمل أن تساعدك هذه الوثيقة على التكامل مع API واستخدامه بشكل أفضل. إذا كانت لديك أي أسئلة، فلا تتردد في الاتصال بفريق الدعم الفني لدينا.

البداية

دردشة الذكاء الاصطناعي

صورة الذكاء الاصطناعي

فيديو الذكاء الاصطناعي

الصوت الذكي

الويب والبيانات

CAPTCHA

الهوية

Coding

المزيد من الأدلة

دليل التكامل مع Producer Audios Generation API

عملية التقديم

الاستخدام الأساسي

الإنشاء المخصص

إعادة غناء الأغنية

متابعة كتابة الأغنية

تحويل الموسيقى

استبدال المقطع

إعادة إصدار المرافقة الموسيقية

إعادة إصدار الصوت البشري

فصل الكلمات والموسيقى

الاستدعاء غير المتزامن

معالجة الأخطاء

مثال على استجابة خطأ

الخلاصة

​عملية التقديم

​الاستخدام الأساسي

​الإنشاء المخصص

​إعادة غناء الأغنية

​متابعة كتابة الأغنية

​تحويل الموسيقى

​استبدال المقطع

​إعادة إصدار المرافقة الموسيقية

​إعادة إصدار الصوت البشري

​فصل الكلمات والموسيقى

​الاستدعاء غير المتزامن

​معالجة الأخطاء

​مثال على استجابة خطأ

​الخلاصة

عملية التقديم

الاستخدام الأساسي

الإنشاء المخصص

إعادة غناء الأغنية

متابعة كتابة الأغنية

تحويل الموسيقى

استبدال المقطع

إعادة إصدار المرافقة الموسيقية

إعادة إصدار الصوت البشري

فصل الكلمات والموسيقى

الاستدعاء غير المتزامن

معالجة الأخطاء

مثال على استجابة خطأ

الخلاصة