Suno واجهة برمجة التطبيقات لاستنساخ الصوت - تعليمات الدمج

​

الخطوة الأولى: إنشاء شخصية صوتية

متطلبات ملف الصوت

• يجب أن يكون تنسيق الصوت WAV أو MP3
• يجب أن تتراوح مدة الصوت بين 10~240 ثانية، يُوصى باستخدام مواد صوتية نظيفة تتراوح بين 30~60 ثانية
• يجب أن يحتوي الصوت على حديث أو غناء واضح وقابل للتعرف عليه من شخص واحد
• يجب تجنب الضوضاء الخلفية، والموسيقى المصاحبة، والصدى، والارتجاع؛ الأغاني الكاملة المصحوبة عادة لا يمكن أن تمر عبر التحقق من بصمة الصوت
• لا يجب أن تحتوي على أكثر من متحدث واحد أو أصوات متعددة
• المواد ذات الصوت المنخفض جدًا، أو الكلام غير الواضح، أو الضوضاء الزائدة قد تؤدي إلى فشل الاستنساخ أو نتائج ضعيفة ملاحظات حول قيود الاستخدام
• الشخصية الصوتية التي تم إنشاؤها عن طريق تحميل الصوت هي موارد خاصة
• هذه الشخصية الصوتية لا تدعم إعادة الاستخدام عبر الحسابات
• يُنصح باستخدامها في أقرب وقت بعد إنشائها، حيث قد يحدث فقدان أو عدم توفر إذا لم يتم استخدامها لفترة طويلة
• الاسم المعاد هو تلقائي من النظام، يرجى الاعتماد على persona_id المعاد

يرجى إعادة المحاولة عند فشل الاستدعاء يعتبر استنساخ الصوت مهمة كثيفة الاستخدام للموارد، حتى مع توافق المواد تمامًا، هناك احتمال معين للفشل العرضي، مثل العودة الشائعة voices_sound_different (فشل التحقق من بصمة الصوت). هذا النوع من الفشل لا يتعلق بجودة الصوت، وعادة ما يمكن أن تنجح إعادة المحاولة باستخدام نفس المادة، يُنصح بتنفيذ 1~2 محاولة تلقائية عند الدمج. الطلبات الفاشلة لن يتم احتسابها.

curl -X POST 'https://api.acedata.cloud/suno/voices' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "audio_url": "https://cdn.acedata.cloud/suno_demo.mp3",
  "name": "My Voice",
  "description": "مثال على صوت شخص واحد واضح"
}'

العنوان https://cdn.acedata.cloud/suno_demo.mp3 هو مادة نموذجية يمكن استدعاؤها مباشرة (MP3، 41 ثانية، صوت شخص واحد). إذا كنت بحاجة إلى مثال بتنسيق WAV، يمكنك استخدام https://cdn.acedata.cloud/uploads/82d23b97-ec1c-4b41-91b8-989fc51f8765 (WAV، 41 ثانية، أحادي 44.1kHz).

{
  "success": true,
  "task_id": "0fa609a6-c8d9-4bb5-8574-e4c93bb55d02",
  "data": {
    "persona_id": "1ab79a71-a229-4350-8f02-402ff02eac16",
    "name": "VOICE_20260803037676",
    "is_public": false
  }
}

​

الخطوة الثانية: استخدام الشخصية الصوتية لإنشاء الموسيقى

ملاحظة: استنساخ الصوت يدعم فقط النماذج chirp-v4-5 وما فوق (مثل chirp-v4-5، chirp-v5، chirp-v5-5)، ولا يدعم chirp-v4.

curl -X POST 'https://api.acedata.cloud/suno/audios' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "action": "generate",
  "model": "chirp-v5-5",
  "prompt": "أغنية دافئة من نوع الساينث-بوب عن ليالي المدينة",
  "persona_id": "1ab79a71-a229-4350-8f02-402ff02eac16"
}'

{
  "success": true,
  "task_id": "53d8a334-a972-43c5-895e-60c4454e88d5",
  "data": [
    {
      "id": "16463960-077c-4700-bbb3-3c7897b943d3",
      "title": "Soft Neon on My Skin",
      "audio_url": "https://platform2.cdn.acedata.cloud/fish/5ade0339-5f11-487e-aacc-06a908271706.mp3",
      "image_url": "https://cdn.acedata.cloud/e724d7f13d.png",
      "model": "chirp-v5-5",
      "state": "succeeded",
      "prompt": "أغنية دافئة من نوع الساينث-بوب عن ليالي المدينة",
      "duration": 156.28
    }
  ]
}