واجهة رفع الصوت المصدر

آخر تحديث 2026-09-18 · فريق Suno-API

وصف نقطة النهاية

رفع الصوت المصدر يحوّل ملفاً صوتياً محلياً أو بعيداً إلى مقطع مصدر يمكن للقدرات اللاحقة استخدامه: الكوفر والتمديد واستبدال المقطع والفصل وغيرها.

نقطة النهاية: POST /api/music/upload-source

الفوترة: مجاني. هذه الواجهة ترفع الصوت المصدر فقط، ولا تبدأ مهمة توليد.

الاستخدام الموصى به: هذه هي الخطوة 1 من «الكوفر بخطوتين». ارفع الصوت أولاً عبر هذه الواجهة (مجاناً، ويمكنك إعادة المحاولة في أي وقت عند الفشل) واحفظ clip_id المُعاد؛ وبعد التأكد من نجاح الرفع (status في حالة مكتملة)، استدعِ واجهة الكوفر من مقطع مصدر لبدء الكوفر — جسم ذلك الطلب لا يتجاوز بضع مئات من البايتات، ولذلك لا يمكن أن يُقطع أثناء النقل لأن الصوت كبير جداً. ومقارنة بواجهة الخطوة الواحدة الرفع ثم الكوفر، فإن هذا التقسيم أكثر ثباتاً عندما يكون الصوت كبيراً أو الشبكة غير مستقرة أو الحاجة إلى إعادة استخدام المادة نفسها عدة مرات (التمديد / الاستبدال / الفصل).

نصائح لرفع الملفات الكبيرة

بعد انتهاء الرفع، تأكد دائماً من أن status في الاستجابة أصبح حالة مكتملة واحفظ clip_id قبل الانتقال إلى الخطوة 2؛ وفشل الرفع لا يُحتسب مالياً ولا ينشئ مهمة توليد، فما عليك سوى إعادة المحاولة.

معاملات الطلب

Headers

لطلبات JSON:

لا تضبط Content-Type يدوياً في طلبات multipart؛ فالعميل يُنشئه تلقائياً.

معاملات الجسم

مثال طلب JSON

curl -X POST https://www.suno-api.io/api/music/upload-source \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "file_url": "https://example.com/source.mp3",
    "file_name": "source.mp3",
    "upload_type": "file_upload"
  }'

مثال طلب multipart

curl -X POST https://www.suno-api.io/api/music/upload-source \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@source.mp3" \
  -F "file_name=source.mp3" \
  -F "upload_type=file_upload" \
  -F "model=suno-v6"

الاستجابة

{
  "clip_id": "uploaded_clip_id",
  "status": "complete",
  "title": "source.mp3",
  "image_url": "https://...",
  "audio_url": "https://...",
  "display_tags": "pop, vocal",
  "inferred_description": "uploaded source audio",
  "clip_metadata": {}
}