ما نقاط نهاية ElevenLabs التي يمكنني استخدامها من OpenClaw؟

تُتيح RunAPI ستة نقاط نهاية لـ ElevenLabs: text_to_speech (turbo-v2.5 وmultilingual-v2)، وtext_to_dialogue (dialogue-v3 للمتحدثين المتعددين)، وtext_to_sound (المؤثرات الصوتية)، وspeech_to_text (التفريغ النصي)، وisolate_audio (استخراج الأصوات). جميعها تشترك في نفس RUNAPI_API_KEY.

ما الفرق بين turbo-v2.5 وmultilingual-v2؟

turbo-v2.5 محسَّن لزمن استجابة منخفض وإخراج يُعطي الأولوية للغة الإنجليزية — ويطبّق صوتاً افتراضياً عند عدم التحديد. أما multilingual-v2 فيدعم 29 لغة ويتطلب معرّف صوت صريحاً وlanguage_code اختياري. يكلّف turbo نحو نصف سعر multilingual بالحرف.

هل تحويل نص ElevenLabs إلى كلام متزامن أم غير متزامن في RunAPI؟

غير متزامن. تُعيد نقطة نهاية الإنشاء task_id فوراً. استطلع نقطة نهاية حالة المهمة أو قدّم callback_url لاستقبال webhook عند جاهزية ملف الصوت للتنزيل.

كيف تُحتسب تكلفة ElevenLabs في RunAPI؟

تُفوتَر نقاط نهاية تحويل النص إلى كلام والحوار بالحرف من النص المُدخل. ويُفوتَر النص إلى نص بالدقيقة من الصوت. ويُفوتَر عزل الصوت بالمهمة. تحقق من صفحة أسعار RunAPI للاطلاع على الأسعار الحالية.

هل يمكنني استخدام dialogue-v3 من ElevenLabs للصوت متعدد المتحدثين في OpenClaw؟

نعم. استدعِ نقطة نهاية text_to_dialogue مع النموذج text-to-dialogue-v3. مرّر مصفوفة dialogue حيث يحتوي كل عنصر على text ومعرّف صوت. يجب ألا يتجاوز إجمالي النص عبر جميع المتحدثين 5000 حرف.

OPENCLAW + ELEVENLABS

استخدم ElevenLabs في OpenClaw.

توفر ElevenLabs ستة نقاط نهاية صوتية عبر RunAPI — تحويل نص إلى كلام turbo-v2.5 بزمن استجابة أقل من ثانية، وmultilingual-v2 يغطي 29 لغة، وdialogue-v3 للمحادثات متعددة المتحدثين، والمؤثرات الصوتية، والتفريغ النصي، وعزل الأصوات. تستدعيها وكلاء OpenClaw بنفس مفتاح RunAPI المستخدم في الدردشة.

احصل على API Key اقرأ الوثائق

مفتاح API واحد · نقطة نهاية تحويل النص إلى كلام · فوترة بالحرف

Use RunAPI to generate speech audio with ElevenLabs text-to-speech.

Requirements:
- Read the API key from RUNAPI_API_KEY.
- Call POST https://runapi.ai/api/v1/elevenlabs/text_to_speech
- Set model to "text-to-speech-turbo-v2.5".
- Set text to the content you want spoken.
- Optionally set voice to a specific ElevenLabs voice ID.
- Optionally set speed between 0.7 and 1.2.
- The task is async. Poll the returned task_id until status is "completed".
- When done, read the audio URL from the response output.

curl -X POST https://runapi.ai/api/v1/elevenlabs/text_to_speech \
  -H "Authorization: Bearer $RUNAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "text-to-speech-turbo-v2.5",
    "text": "Welcome to RunAPI. This audio was generated by ElevenLabs turbo v2.5.",
    "speed": 1.0,
    "stability": 0.5,
    "similarity_boost": 0.75
  }'

{
  "task_id": "tsk_abc123",
  "status": "pending",
  "model": "text-to-speech-turbo-v2.5"
}

انسخ أمر curl للاختبار elevenlabs

HOW IT WORKS

استخدم ElevenLabs في OpenClaw في ثلاث خطوات

هيّئ RunAPI

عيّن RUNAPI_API_KEY في بيئتك. إذا كنت قد هيّأت RunAPI مسبقاً للدردشة في OpenClaw، فإن نفس المفتاح يعمل مع جميع نقاط نهاية ElevenLabs — تحويل النص إلى كلام، والنص إلى نص، والحوار، والمؤثرات الصوتية، وعزل الصوت.

export RUNAPI_API_KEY=runapi_xxx

استدعِ text_to_speech

أرسل طلب POST إلى نقطة نهاية text_to_speech مع تعيين النموذج على text-to-speech-turbo-v2.5، والنص المراد تحويله إلى كلام، ومعاملات اختيارية للصوت والسرعة والثبات. للإخراج متعدد اللغات، استخدم text-to-speech-multilingual-v2 مع voice وlanguage_code.

POST /api/v1/elevenlabs/text_to_speech

استطلع النتيجة

تُعيد نقطة النهاية task_id فوراً. استطلع نقطة نهاية حالة المهمة حتى تصبح الحالة مكتملة، ثم اقرأ رابط الصوت من الاستجابة.

GET /api/v1/elevenlabs/text_to_speech/tsk_abc123

PARAMETERS

معاملات واجهة برمجة text_to_speech لـ ElevenLabs

المعامل	النوع	الوصف
`model`	`string`	مطلوب. text-to-speech-turbo-v2.5 (زمن استجابة منخفض) أو text-to-speech-multilingual-v2 (29 لغة).
`text`	`string`	مطلوب. النص المراد تحويله إلى كلام. الحد الأقصى 5000 حرف.
`voice`	`string`	معرّف صوت ElevenLabs. مطلوب لـ multilingual-v2. يستخدم turbo-v2.5 صوتاً افتراضياً إذا لم يُحدَّد.
`speed`	`float`	اختياري. مضاعف سرعة التشغيل. النطاق من 0.7 إلى 1.2.
`stability`	`float`	اختياري. اتساق الصوت. النطاق من 0.0 إلى 1.0. القيم المنخفضة تضيف تعبيرية.
`similarity_boost`	`float`	اختياري. تعزيز تشابه الصوت. النطاق من 0.0 إلى 1.0.
`style`	`float`	اختياري. مبالغة الأسلوب. النطاق من 0.0 إلى 1.0.
`language_code`	`string`	اختياري. اللغة المستهدفة لـ multilingual-v2، مثل en أو es أو ja.
`callback_url`	`string`	اختياري. رابط webhook يستقبل طلب POST عند اكتمال المهمة.

ما هو ElevenLabs في OpenClaw؟

ElevenLabs API تحويل النص إلى كلام المفضّل للمخرجات الصوتية الطبيعية. تدعم النماذج الأصوات القابلة للاستنساخ والمخرجات متعددة اللغات بـ 29 لغة وتوليد مؤثرات صوتية. تستدعيه وكلاء OpenClaw عبر RunAPI بنفس مفتاح API المستخدم للمحادثة.