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

​

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

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

• يجب أن يكون تنسيق الصوت WAV أو MP3
• يجب أن تتراوح مدة الصوت بين 10~240 ثانية، ويوصى باستخدام مادة صوتية نظيفة وجافة لشخص واحد لمدة 30~60 ثانية
• يجب أن يحتوي الصوت على صوت بشري واضح وقابل للتعرّف لشخص واحد يتحدث أو يغني
• يُرجى التأكد من تجنب ضوضاء الخلفية، والمرافقة الموسيقية، والصدى، والارتداد الصوتي؛ إذ إن الأغاني الكاملة المصحوبة بمرافقة موسيقية لا تجتاز عادةً التحقق من البصمة الصوتية
• لا تضمّن عدة متحدثين أوأصواتًا بشرية متعددة
• قد تؤدي المواد ذات مستوى الصوت المنخفض جدًا أو الكلام غير الواضح أو الضوضاء الشديدة إلى فشل الاستنساخ أوضعف نتيجة التوليد توضيح قيود الاستخدام
• الشخصيات الصوتية التي يتم إنشاؤها عبر رفع الصوت هي موارد خاصة
• هذه الشخصية الصوتية لا تدعم إعادة الاستخدام عبر الحسابات
• يُنصح باستخدامها في أقرب وقت ممكن بعد نجاح الإنشاء، فقد تصبح غير صالحة أو غير متاحة إذا لم تُستخدم لفترة طويلة
• يتم إنشاء name المُعاد تلقائيًا بواسطة النظام، ويُرجى الاعتماد على 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": "A warm synth-pop song about city nights",
  "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://cdn.acedata.cloud/assets/examples/fish/5ade0339-5f11-487e-aacc-06a908271706-8e3fcb0e5547.mp3",
      "image_url": "https://cdn.acedata.cloud/e724d7f13d.png",
      "model": "chirp-v5-5",
      "state": "succeeded",
      "prompt": "A warm synth-pop song about city nights",
      "duration": 156.28
    }
  ]
}

{
  "action": "upload_cover",
  "model": "chirp-v6",
  "audio_id": "<与该声音关联上传后返回的 audio_id>",
  "persona_id": "<声音创建接口返回的 persona_id>",
  "custom": true,
  "instrumental": false,
  "lyric": "[Verse]\n填写要演唱的歌词",
  "async": true
}