Skip to main content
واجهة برمجة تطبيقات Suno MP3 URL تولد مسارًا لعنوان قابل للتشغيل ينتهي بـ .mp3 لموسيقى موجودة، وهي مناسبة لحالات تعطل روابط التنزيل القديمة، أو التشغيل على الأجهزة المحمولة، أو الحاجة إلى إعادة الحصول على عنوان الصوت العام. المعلمة المطلوبة audio_id هي معرف الصوت الذي ترجع به واجهة توليد الصوت من Suno. كل استدعاء ينشئ مهمة URL MP3 مستقلة، ولن يعدل مهمة توليد الموسيقى الأصلية، ولن يغير معرف الصوت الأصلي.

الاستدعاء المتزامن

عند النجاح، data[0].file_url هو عنوان الصوت القابل للتشغيل. ستقوم الواجهة بتخزينه أولاً في https://cdn.acedata.cloud/suno/{audio_id}.mp3؛ إذا فشلت عملية التخزين، فستعيد العنوان الأصلي المتاح.

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

عند الحاجة إلى وقت معالجة أطول، يمكن تمرير async: true:
بعد ذلك، يمكن الاستعلام عن export_task_id من خلال /suno/tasks. يمكن أيضًا تقديم callback_url لاستقبال النتيجة النهائية بعد إكمال المهمة. تستخدم الاستجابة المتزامنة، واستعلام المهمة، والاستدعاء نفس بنية البيانات النهائية.

ملاحظات

  • يجب أن يأتي audio_id من صوت Suno يمكن التعرف عليه.
  • مهام URL MP3 مستقلة عن مهام توليد الموسيقى الأصلية.
  • الفشل في التخزين لن يمنع النتائج، وسيعود إلى العنوان الأصلي؛ يرجى التنزيل في الوقت المناسب.
  • يُنصح بأن يقوم الجانب التجاري بتنزيل النتائج في الوقت المناسب وحفظها وفقًا لاستراتيجية الاحتفاظ بالبيانات الخاصة بهم.