استخدم ElevenLabs Dialogue V3 عبر Rivya Public API v1 مع معرف النموذج elevenlabs-dialogue-v3، والمدخلات المدعومة، والمعلمات، وقواعد Files API، والرصيد، وأمثلة الاستجابة.

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

معرف نموذج API

elevenlabs-dialogue-v3

المدخلات

text

Files API

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

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

القدرة

صوت

الفوترة

METERED

حد prompt

5000 أحرف

عقد الطلب

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

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

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

المفتاح	النوع	مطلوب	الافتراضي	النطاق	الخيارات	الوصف
default_voice	select	لا	Adam	-	Adam, Alice, Bill, Brian, Callum, Charlie, Chris, Daniel, Eric, George, Harry, Jessica, Laura, Liam, Lily, Matilda, River, Roger, Sarah, Will	الصوت الافتراضي
stability	select	لا	0.5	-	0, 0.5, 1	الثبات
language_code	text	لا	-	-	-	رمز اللغة

الطلب الأدنى

{
  "model": "elevenlabs-dialogue-v3",
  "prompt": "A polished audio concept for a short product story",
  "params": {
    "default_voice": "Adam",
    "stability": "0.5",
    "dialogue": [
      {
        "voice": "Adam",
        "text": "Welcome to the product walkthrough."
      },
      {
        "voice": "Alice",
        "text": "Here is the short version for developers."
      }
    ]
  }
}

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

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

{
  "id": "task_elevenlabs_dialogue_v3_example",
  "status": "queued",
  "model": "elevenlabs-dialogue-v3",
  "reserved_credits": 14,
  "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