استخدم ElevenLabs Turbo 2.5 عبر Rivya Public API v1 مع معرف النموذج elevenlabs-turbo-2-5، والمدخلات المدعومة، والمعلمات، وقواعد Files API، والرصيد، وأمثلة الاستجابة.

متاح عبر APIإدخال النص جاهزالصوت

معرف نموذج API

elevenlabs-turbo-2-5

المدخلات

text

Files API

غير مطلوب للطلب الأدنى

الرصيد الأساسي

القدرة

الصوت

الفوترة

METERED

حد prompt

5000 أحرف

عقد الطلب

أرسل معرف النموذج في المستوى الأعلى. توضع عناصر التحكم الخاصة بالنموذج داخل params.

المفتاح	النوع	مطلوب	الافتراضي	الوصف
model	string	نعم	elevenlabs-turbo-2-5	استخدم معرف نموذج API وهو elevenlabs-turbo-2-5.
prompt	string	نعم	-	الحد الأقصى لهذا النموذج هو 5000 حرفا.
params	object	نعم	-	كائن معلمات خاص بالنموذج. استخدم الصفوف أدناه لمعرفة المفاتيح المسموح بها.
client_request_id	string	لا	-	معرف اختياري من جهة العميل لتتبع الطلبات في نظامك.

معلمات النموذج

المفتاح	النوع	مطلوب	الافتراضي	النطاق	الخيارات	الوصف
voice	select	نعم	TX3LPaxmHKxFdv7VOQHJ	-	TX3LPaxmHKxFdv7VOQHJ, cgSgspJ2msm6clMCkdW9, pNInz6obpgDQGcFmaJgB, BIvP0GN1cAtSRTxNHnWS, aMSt68OGf4xUZAnLpTU8	الصوت
stability	number	لا	0.5	min 0 / max 1 / step 0.05	-	الثبات
similarity_boost	number	لا	0.75	min 0 / max 1 / step 0.05	-	تعزيز التشابه
style	number	لا	0	min 0 / max 1 / step 0.05	-	الأسلوب
speed	number	لا	1	min 0.7 / max 1.2 / step 0.05	-	السرعة
timestamps	select	لا	false	-	false, true	الطوابع الزمنية
previous_text	text	لا	-	-	-	النص السابق
next_text	text	لا	-	-	-	النص التالي
language_code	text	لا	-	-	-	رمز اللغة

الطلب الأدنى

{
  "model": "elevenlabs-turbo-2-5",
  "prompt": "A polished audio concept for a short product story",
  "params": {
    "voice": "TX3LPaxmHKxFdv7VOQHJ",
    "stability": 0.5,
    "similarity_boost": 0.75,
    "style": 0,
    "speed": 1,
    "timestamps": "false",
    "previous_text": "سياق اختياري قبل هذا السطر",
    "next_text": "سياق اختياري بعد هذا السطر",
    "language_code": "رمز لغة اختياري مثل en أو zh"
  }
}

استجابة الإنشاء

يعيد endpoint الإنشاء معرف مهمة عاما. استعلم عن endpoint الحالة حتى تنجح المهمة أو تفشل.

{
  "id": "task_elevenlabs_turbo_2_5_example",
  "status": "queued",
  "model": "elevenlabs-turbo-2-5",
  "reserved_credits": 6,
  "final_credits": 0,
  "created_at": "2026-05-11T00:00:00.000Z",
  "updated_at": "2026-05-11T00:00:00.000Z",
  "result": null,
  "error": null
}

الأخطاء الشائعة

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found