النماذج المدعومة

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

نماذج الإنشاء المتاحة

لا تقبل الطلبات إلا أسماء نماذج المنصة المذكورة أدناه. أما الأسماء الأخرى، بما فيها الأسماء الشبيهة بنموذج موجود، فلا تُقبل.

النموذج الافتراضي الموصى به: suno-v6.

حول فصل المسارات

فصل المسارات ميزة ثابتة ومستقلة: لا تحتاج إلى اختيار نموذج إنشاء. أرسل المقطوعة الأصلية ووضع الفصل (مثل two أو twelve) فقط. وعدد المسارات المُعادة هو ما تذكره الاستجابة.

المعامل model

في نقاط الإنشاء يكون model اختياريًا عادةً:

• إذا حُذف: يُستخدم الافتراضي suno-v6.
• إذا ذُكر: يجب أن يكون suno-v6 أو suno-v6-wild أو suno-v6-mini.
• لا تُقبل إلا أسماء النماذج الواردة في الجدول أعلاه.

أقل مثال للإنشاء

curl -X POST https://www.suno-api.io/api/music/create \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "description": "أغنية فولك مبهجة عن أول يوم من الربيع",
    "model": "suno-v6"
  }'

مثال مع إحدى نسخ V6

{
  "model": "suno-v6-wild",
  "description": "مقطوعة إلكترونية ببنية تجريبية"
}

النماذج الموقوفة

هذه النماذج لم تعد تقبل طلبات جديدة:

• suno-v2
• suno-v3
• suno-v3-5
• suno-v4
• suno-v4-5
• suno-v4-5-all
• suno-v4-5-plus
• suno-v5
• suno-v5-5

قد تعرض المقطوعات والمهام القديمة قيمة model_name أو model_version القديمة. وهذه بيانات تاريخية لا تعني أن النموذج القديم يقبل طلبات جديدة.

وللتوافق مع العملاء الحاليين، يُعالج الطلب الذي يذكر نموذجًا موقوفًا بالنموذج الافتراضي الحالي suno-v6 بدل رفضه، وتُسجّل المهمة باسم suno-v6 دون إرجاع خطأ «النموذج غير متاح». ومع ذلك، حدّث أمثلتك إلى الأسماء الحالية في أقرب وقت.

عرض قائمة النماذج

ينبغي أن يتضمن GET /v1/models على الأقل نماذج الموسيقى التالية:

{
  "object": "list",
  "data": [
    { "id": "suno-v6", "object": "model", "owned_by": "suno" },
    { "id": "suno-v6-wild", "object": "model", "owned_by": "suno" },
    { "id": "suno-v6-mini", "object": "model", "owned_by": "suno" }
  ]
}

قد تتضمن الاستجابة أيضًا نماذج الكلمات أو مسارات توافق أو نماذج داخلية. لا تخلط بينها وبين نماذج V6 الخاصة بإنشاء الموسيقى.

اختيار نسخة V6

في معظم التكاملات يكفي النموذج الافتراضي. وتختلف النسخ الثلاث في مدى الالتزام بالوصف ومدى تنوع النتيجة.

ولأن كل تشغيل يعيد مقطوعتين، فالمسار العملي هو الرسم بـ suno-v6-mini ثم تشغيل الوصف المعتمد على suno-v6 لاختيار النسخة التي ستنشرها.

التكلفة والاسترداد

التسعير لكل طلب لا لكل نموذج: كل تشغيل يكلف 0,6 ¥ ويعيد مقطوعتين. وعمليات الإنشاء الفاشلة تُرد تلقائيًا، فلا تستهلك محاولة فاشلة أي رصيد. أما التنزيل فغير محدود ولا يُحتسب بشكل منفصل أبدًا.