نماذج تغيير الصوت غير مقبولة على هذه النقاط النهائية. حوّل تسجيلًا مصدرًا باستخدام واجهة برمجة تطبيقات تغيير الصوت بدلًا من ذلك.
اختيار نموذج
تصفَّح نماذج الموسيقى والمؤثرات الصوتية للاطلاع على معرّفات النماذج الحالية والأسعار وحدود المدة والميزات المدعومة. يمكنك أيضًا استكشاف قدرات النماذج في وقت التشغيل:duration_seconds أو lyrics_prompt أو force_instrumental أو loop. الحقول غير المدعومة تؤدي إلى استجابة HTTP 400.
سير عملية التوليد
1. احصل على عرض سعر
اطلب عرض سعر للطلب قبل توليد الوسائط. أدرج النموذج والمدة نفسيهما اللذين تعتزم إرسالهما إلى نقطة نهاية قائمة الانتظار.elevenlabs-music مدته 30 ثانية وفق شريحة الـ 60 ثانية. راجع pricing لكل نموذج في GET /models?type=music لمعرفة شرائحه أو سعره لكل ثانية.
2. ضع عملية التوليد في قائمة الانتظار
model وqueue_id؛ فنقطتا نهاية الاسترجاع والإكمال تتطلبانهما.
3. الاستعلام الدوري والتنزيل
استدعِ/audio/retrieve بالقيم المُستلمة من استجابة قائمة الانتظار:
Content-Type في الاستجابة:
يعتمد نوع الصوت على صيغة إخراج النموذج. راجع
default_format وsupported_formats في البيانات الوصفية للنموذج؛ فعلى سبيل المثال، تُرجع النماذج التي تُخرج m4a النوع audio/mp4.
تبدو استجابة المعالجة كما يلي:
مثال كامل
يضع مثال Python هذا موسيقى آلية في قائمة الانتظار، ويستعلم دوريًا كل خمس ثوانٍ، ويحفظ النتيجة بامتداد يستند إلى نوع المحتوى.لا تتطلب نقطة نهاية عرض السعر مصادقة، لكن طلبات قائمة الانتظار والاسترجاع والإكمال تتطلبها.
نصائح لكتابة المطالبات
- بالنسبة للموسيقى، صِف النوع والآلات والمزاج والإيقاع والبنية وما إذا كانت الأصوات مطلوبة.
- بالنسبة للمؤثرات الصوتية، صِف المصدر والبيئة والشدة والتوقيت ومنظور الاستماع.
- استخدم
lyrics_promptفقط عندما يدعم النموذج المُختار كلمات الأغاني. - استخدم
force_instrumentalأوloopفقط عندما تُفيد بيانات النموذج التعريفية بدعمهما.