> ## Documentation Index
> Fetch the complete documentation index at: https://veniceai-mintlify-ce69695c.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# نماذج الموسيقى والمؤثرات الصوتية

> نماذج الموسيقى والصوت في Venice للأغاني والمقاطع الآلية والمؤثرات الصوتية، بما في ذلك ElevenLabs Music وLyria 3 Pro وMiniMax Music.

<div id="model-search-placeholder" data-filter="music">
  استخدم قيمة `id` كمعامل `model` في طلبات API. عدد النماذج المتوفرة حاليًا: 16.

  | النموذج | المعرّف | التسعير | الخصوصية |
  | - | - | - | - |
  | ACE-Step 1.5 | `ace-step-15` | متدرّج حسب المدة، استخدم واجهة Audio Quote API | Anonymized |
  | ElevenLabs Multilingual v2 | `elevenlabs-tts-multilingual-v2` | راجع واجهة Audio Quote API | Anonymized |
  | ElevenLabs Music | `elevenlabs-music` | متدرّج حسب المدة، استخدم واجهة Audio Quote API | Anonymized |
  | ElevenLabs Music v2 | `elevenlabs-music-v2` | متدرّج حسب المدة، استخدم واجهة Audio Quote API | Anonymized |
  | ElevenLabs Music v2.5 | `elevenlabs-music-v2-5` | متدرّج حسب المدة، استخدم واجهة Audio Quote API | Anonymized |
  | ElevenLabs Sound Effects | `elevenlabs-sound-effects-v2` | \$0.0023 / ثانية | Anonymized |
  | ElevenLabs TTS v3 | `elevenlabs-tts-v3` | راجع واجهة Audio Quote API | Anonymized |
  | Lyria 3 Pro | `lyria-3-pro` | \$0.10 / توليد | Anonymized |
  | MiniMax Music 2.0 | `minimax-music-v2` | \$0.04 / توليد | Anonymized |
  | MiniMax Music 2.5 | `minimax-music-v25` | \$0.18 / توليد | Anonymized |
  | MiniMax Music 2.6 | `minimax-music-v26` | \$0.18 / توليد | Anonymized |
  | MMAudio V2 | `mmaudio-v2-text-to-audio` | \$0.0009 / ثانية | Anonymized |
  | Seed Audio 1.0 | `seed-audio-1-0` | \$0.0029 / ثانية | Anonymized |
  | Sonilo V1.1 Music | `sonilo-v1-1-music` | \$0.0029 / ثانية | Anonymized |
  | Sonilo V1.1 Sound Effects | `sonilo-v1-1-sound-effects` | \$0.0021 / ثانية | Anonymized |
  | Stable Audio 2.5 | `stable-audio-25` | \$0.19 / توليد | Anonymized |
</div>

## فئات النماذج

**توليد الأغاني:** أنشئ أغاني كاملة مع كلمات اختيارية ودعم صوتي

* ACE-Step 1.5, ElevenLabs Music, MiniMax Music 2.0

**الموسيقى والمؤثرات الصوتية:** ولِّد موسيقى آلية أو مؤثرات صوتية من مطالبات نصية

* Stable Audio 2.5

**المؤثرات الصوتية:** ولِّف المؤثرات الصوتية والأصوات المحيطة من مطالبات نصية

* ElevenLabs Sound Effects, MMAudio V2

<Tip>
  يولّد `force_instrumental` موسيقى بدون أصوات. وهو مدعوم من ElevenLabs Music و MiniMax Music 2.5 و MiniMax Music 2.6 — تحقق من `supports_force_instrumental` في استجابة `/models` بدلًا من افتراض نموذج واحد.
</Tip>

<Note>
  يستخدم توليد الصوت نظام قائمة انتظار غير متزامن. اتبع [دليل الموسيقى والمؤثرات الصوتية](/ar/guides/media/music-and-sound-effects) للحصول على شرح تفصيلي كامل، أو راجع [واجهة Audio Queue API](/ar/api-reference/endpoint/audio/queue) لبدء التوليد و[واجهة Audio Retrieve API](/ar/api-reference/endpoint/audio/retrieve) لجلب النتائج. النماذج التي يكون فيها `model_spec.voice_changer` مضبوطًا على `true` تستخدم نقاط نهاية [تغيير الصوت](/ar/guides/media/voice-changer) بدلًا من ذلك.
</Note>

## التسعير

يختلف التسعير حسب النموذج:

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

للحصول على عروض أسعار دقيقة قبل التوليد، استخدم [واجهة Audio Quote API](/ar/api-reference/endpoint/audio/quote).

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

النماذج ذات التسعير المتدرج حسب المدة تقبل أي `duration_seconds` ضمن نطاق `min_duration`–`max_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 لكل دقيقة، مع تقريب لأعلى لأقرب دقيقة:

| نطاق المدة | مفتاح المستوى | السعر الأساسي |
| - | - | - |
| 3–60s | `60` | \$0.75 |
| 61–120s | `120` | \$1.50 |
| 121–180s | `180` | \$2.25 |
| 181–240s | `240` | \$3.00 |
| 241–300s | `300` | \$3.75 |
| 301–360s | `360` | \$4.50 |
| 361–420s | `420` | \$5.25 |
| 421–480s | `480` | \$6.00 |
| 481–540s | `540` | \$6.75 |
| 541–600s | `600` | \$7.50 |

هذه أسعار أساسية قبل الترميز. استخدم [واجهة Audio Quote API](/ar/api-reference/endpoint/audio/quote) للحصول على السعر الدقيق الذي سيتم احتسابه.

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

| المعامل | الوصف |
| - | - |
| `prompt` | وصف نصي للصوت المراد توليده |
| `lyrics_prompt` | كلمات الأغنية للنماذج الصوتية (مطلوب عندما يحتوي النموذج على `lyrics_required=true`) |
| `duration_seconds` | طول الإخراج بالثواني |
| `force_instrumental` | التوليد بدون أصوات (حيث يكون مدعومًا) |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.