الانتقال إلى المحتوى الرئيسي
POST /suno/availability تبحث بناءً على audio_id عن أدلة إيجابية تفيد بأن الصوت يمكن متابعة معالجته على المسار الحالي. يمكن استدعاؤها قبل عمليات مثل المتابعة الكتابية وإعادة الغناء؛ وتعكس النتيجة الحالة وقت الفحص فقط، ولا تضمن بالضرورة نجاح عملية محددة. تُرجع هذه الواجهة النتيجة بشكل متزامن، وتتطلب API Token، ولا تخصم Credits حاليًا. audio_id هو معرّف الأغنية الذي تُرجعه مهمة Suno المكتملة، وليس task_id.
مثال على استجابة ناجحة:
عند نجاح الفحص، لن تكون قيمة data.available سوى true. إن حالة «غير متصل» التي تُرجعها بعض المسارات لا يمكن أن تثبت أن عمليات لاحقة مثل المتابعة الكتابية لا يمكن أن تنجح، لذلك تُرجع هذه الواجهة 503 availability_unknown عند تعذر التأكد، ولن تُرجع false. يؤدي خطأ في تنسيق audio_id إلى إرجاع 400، كما تُرجع أخطاء أيضًا عند تقييد المعدل أو تعطل الخدمة المصدر. قد تتغير الحالة أيضًا بين اكتمال الفحص وتنفيذ العملية الفعلية.