الانتقال إلى المحتوى الرئيسي

Documentation Index

Fetch the complete documentation index at: https://docs.xhuoapi.ai/llms.txt

Use this file to discover all available pages before exploring further.

تسمح لنا SUNO بإنشاء شخصيات صوتية مخصصة من خلال أي ملف صوتي، لتحقيق استنساخ الصوت لاستخدامه في توليد الموسيقى. بخلاف واجهة برمجة التطبيقات Persona API الموجودة (التي تستخدم audio_id الذي تم إنشاؤه بواسطة Suno)، تقبل هذه الواجهة رابط audio_url متاحًا للعامة، وهو تسجيل صوتي بشري خاص بك. تشرح هذه الوثيقة كيفية دمج واجهة برمجة تطبيقات استنساخ الصوت.

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

تحتوي هذه الواجهة على ثلاثة معلمات إدخال: audio_url (إلزامي)، وهو رابط ملف صوتي بصيغة MP3 أو WAV متاح للعامة ويحتوي على صوت بشري واضح لشخص واحد؛ وname وdescription (اختياريان)، وهما اسم ووصف الشخصية الصوتية. متطلبات ملف الصوت:
  • الصيغة: MP3 أو WAV
  • الطول: لا يقل عن 10 ثوانٍ
  • المحتوى: صوت بشري واضح لشخص واحد، مع تقليل الضوضاء الخلفية أو الموسيقى قدر الإمكان
curl -X POST 'https://api.xhuoapi.ai/v1/suno/voices' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "audio_url": "http://cos.aitutu.cc/mp4/ru-user-voice.mp3",
  "name": "RU User Voice Test",
  "description": "用户语音录音示例"
}'
النتيجة كما يلي: 
{
  "success": true,
  "task_id": "b9150e51-d87c-4556-a55e-100947a63bdf",
  "data": {
    "persona_id": "e95013f8-eaee-4741-a42f-1d559a9d0b2b",
    "name": "RU User Voice Test",
    "is_public": false
  }
}
يمكن ملاحظة أن حقل persona_id في data هو معرف الشخصية الصوتية التي تم إنشاؤها. حقل is_public يكون دائمًا false لأن الشخصيات الصوتية التي تم إنشاؤها عبر رفع الصوت هي خاصة.

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

بعد الحصول على معرف الشخصية الصوتية، يمكننا استخدام واجهة برمجة تطبيقات توليد الصوتيات Suno لتوليد الموسيقى. قم بتعيين action إلى generate، وpersona_id إلى معرف الشخصية الصوتية الذي تم إرجاعه أعلاه، وسيتم أداء الأغنية باستخدام الصوت المستنسخ.
ملاحظة: استنساخ الصوت مدعوم فقط للنماذج chirp-v4-5 وما فوق (مثل chirp-v4-5، chirp-v5، chirp-v5-5)، ولا يدعم chirp-v4. 
curl -X POST 'https://api.xhuoapi.ai/v1/suno/audios' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "action": "generate",
  "model": "chirp-v5-5",
  "prompt": "A warm synth-pop song about city nights",
  "persona_id": "e95013f8-eaee-4741-a42f-1d559a9d0b2b"
}'
النتيجة كما يلي: 
{
  "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://cdn1.suno.ai/16463960-077c-4700-bbb3-3c7897b943d3.mp3",
      "image_url": "https://cdn2.suno.ai/image_16463960-077c-4700-bbb3-3c7897b943d3.jpeg",
      "model": "chirp-v5-5",
      "state": "succeeded",
      "prompt": "A warm synth-pop song about city nights",
      "duration": 156.28
    }
  ]
}
يمكن ملاحظة أن الأغنية المولدة تم أداؤها باستخدام الصوت المستنسخ. يمكن أيضًا استخدام persona_id مع إجراء cover لإعادة أداء أغاني موجودة باستخدام الصوت المستنسخ.