Skip to main content
استخدم قيمة id كمعامل model في طلبات API. عدد النماذج المتوفرة حاليًا: 14.

فئات النماذج

توليد الأغاني: أنشئ أغاني كاملة مع كلمات اختيارية ودعم صوتي
  • ACE-Step 1.5, ElevenLabs Music, MiniMax Music 2.0
الموسيقى والمؤثرات الصوتية: ولِّد موسيقى آلية أو مؤثرات صوتية من مطالبات نصية
  • Stable Audio 2.5
المؤثرات الصوتية: ولِّف المؤثرات الصوتية والأصوات المحيطة من مطالبات نصية
  • ElevenLabs Sound Effects, MMAudio V2
يولّد force_instrumental موسيقى بدون أصوات. وهو مدعوم من ElevenLabs Music و MiniMax Music 2.5 و MiniMax Music 2.6 — تحقق من supports_force_instrumental في استجابة /models بدلًا من افتراض نموذج واحد.
يستخدم توليد الصوت نظام قائمة انتظار غير متزامن. اتبع دليل الموسيقى والمؤثرات الصوتية للحصول على شرح تفصيلي كامل، أو راجع واجهة Audio Queue API لبدء التوليد وواجهة Audio Retrieve API لجلب النتائج.

التسعير

يختلف التسعير حسب النموذج:
  • لكل توليد: سعر ثابت لكل مقطع صوتي (MiniMax Music 2.0, Stable Audio 2.5)
  • متدرج حسب المدة: يتوسع السعر حسب مستوى المدة (ElevenLabs Music, ACE-Step 1.5)
  • لكل ثانية: السعر بناءً على مدة الإخراج (ElevenLabs Sound Effects, MMAudio V2)
للحصول على عروض أسعار دقيقة قبل التوليد، استخدم واجهة Audio Quote API.

التسعير المتدرج حسب المدة

النماذج ذات التسعير المتدرج حسب المدة تقبل أي duration_seconds ضمن نطاق min_durationmax_duration للنموذج، إلا إذا أبلغ النموذج أيضًا عن duration_options — ففي تلك الحالة تُقبل تلك القيم بالضبط فقط وأي قيمة أخرى تعيد 400. على سبيل المثال، لا يقبل ACE-Step 1.5 سوى 60 و 90 و 120 و 150 و 180 و 210، لذا تُرفض duration_seconds: 75 رغم وقوعها داخل النطاق المعلَن. تحقق دائمًا من duration_options قبل الرجوع إلى min_duration/max_duration. يتم تحديد السعر بناءً على المستوى الذي تقع فيه المدة المطلوبة. تُعاد نطاقات المستويات في استجابة /models ضمن pricing.durations، مع min_seconds و max_seconds لكل مستوى. على سبيل المثال، ElevenLabs Music يقبل 3–600 ثانية (حتى 10 دقائق) بسعر $0.75 لكل دقيقة، مع تقريب لأعلى لأقرب دقيقة: هذه أسعار أساسية قبل الترميز. استخدم واجهة Audio Quote API للحصول على السعر الدقيق الذي سيتم احتسابه.

المعاملات الرئيسية