الانتقال إلى المحتوى الرئيسي
يتيح لنا SUNO رفع صوت مرجعي لإجراء إبداع ثانوي، وتشرح هذه الوثيقة طريقة تكامل واجهة برمجة التطبيقات ذات الصلة. يتطلب الرفع العادي فقط audio_url، وهو عنوان صوت CDN يمكن الوصول إليه علنًا. القيمة الافتراضية لـ mode هي standard، لذلك لا تحتاج الاستدعاءات الحالية إلى تعديل. يستهلك الرفع العادي الناجح 0.06 Credits؛ ولا يتم الخصم عند فشل الرفع. عنوان audio_url الذي ندخله هنا هو https://cdn.acedata.cloud/suno_demo.mp3، وهو عنوان CDN يمكن الوصول إليه علنًا.
النتيجة كما يلي:
يمكن ملاحظة أن data يكون دائمًا كائنًا، وaudio_id هو معرّف الأغنية بعد الرفع. حقول نتائج التحليل مثل lyric وstyle وduration والعنوان وعناوين URL للوسائط هي حقول اختيارية، ويعتمد ذلك تحديدًا على المحتوى المُعاد. بعد الحصول على معرّف الأغنية، يمكن استدعاء عمليات upload_extend أو upload_cover أو أخذ عينات من نطاقات وغيرها من العمليات التي تتطلب audio_id عبر واجهة برمجة التطبيقات لإنشاء أصوات Suno. إذا أردت إنشاء موسيقى جديدة استنادًا إلى 1 إلى 4 مقاطع صوتية مرجعية كاملة باستخدام ميزة الإبداع بالإلهام Inspo، فاستدعِ مباشرةً action=inspo ومرّر قائمة عناوين URL الصوتية العامة الأصلية؛ ستُكمل الخدمة تلقائيًا الرفع والتحليل، ولا حاجة لأن يجمع العميل بيانات metadata الصوتية.

وضع الرفع المحسّن

audio_url هو عنوان الإدخال، وسيُمرّر مباشرةً إلى عملية معالجة الصوت، ولن تُجري خدمة التخزين الدائم للوسائط في الحالة النهائية نقلًا مسبقًا له. يُرجى التأكد من إمكانية الوصول إليه علنًا أثناء معالجة المهمة.
عندما يتعذر على الرفع العادي معالجة الصوت الذي تملكه أو المصرح لك باستخدامه، يمكنك تعيين mode إلى enhanced. يجب أن يوفر هذا الوضع أيضًا name من 1 إلى 100 حرف، وأن يستخدم audio_url عبر HTTPS يمكن الوصول إليه علنًا. يعتمد الرفع المحسّن معالجة غير متزامنة بشكل ثابت، وعادةً ما يتطلب دقيقتين أو أكثر. تستهلك المعالجة الناجحة 1.87 Credits؛ ولا يتم الخصم عند فشل المعالجة.
ستُعيد الواجهة فورًا task_id وtrace_id. استخدم واجهة برمجة التطبيقات لمهام Suno للاستعلام عن المهمة، وبعد النجاح اقرأ معرّف الصوت بعد الرفع من response.data.audio_id. ويمكنك أيضًا توفير callback_url عبر HTTPS لتلقي الحالة النهائية. يمكن استخدام audio_id الناتج عن الرفع المحسّن في Cover وSamples وMashup. قد يظل استخراج الموسيقى المصاحبة وMIDI، وفصل جميع المسارات، وكذلك فصل الغناء/الموسيقى المصاحبة، مقيّدًا بالحساب الذي ينتمي إليه الصوت؛ ولا يُضمن دعم الاستخدام عبر الحسابات للعمليات غير المذكورة. كلما كان الصوت أقصر، كان معدل نجاح المعالجة أعلى عادةً.