---
title: "استخدام ElevenLabs في OpenClaw عبر RunAPI — دليل واجهة برمجة الصوت"
url: "https://runapi.ai/ar/openclaw-elevenlabs.md"
canonical: "https://runapi.ai/ar/openclaw-elevenlabs"
locale: "ar"
model: "elevenlabs"
---

# استخدم ElevenLabs في OpenClaw.

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

## API example

```bash
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
  }'

```

### Response

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

```

## How it works

1. **هيّئ RunAPI** — عيّن RUNAPI_API_KEY في بيئتك. إذا كنت قد هيّأت RunAPI مسبقاً للدردشة في OpenClaw، فإن نفس المفتاح يعمل مع جميع نقاط نهاية ElevenLabs — تحويل النص إلى كلام، والنص إلى نص، والحوار، والمؤثرات الصوتية، وعزل الصوت.
2. **استدعِ text_to_speech** — أرسل طلب POST إلى نقطة نهاية text_to_speech مع تعيين النموذج على text-to-speech-turbo-v2.5، والنص المراد تحويله إلى كلام، ومعاملات اختيارية للصوت والسرعة والثبات. للإخراج متعدد اللغات، استخدم text-to-speech-multilingual-v2 مع voice وlanguage_code.
3. **استطلع النتيجة** — تُعيد نقطة النهاية task_id فوراً. استطلع نقطة نهاية حالة المهمة حتى تصبح الحالة مكتملة، ثم اقرأ رابط الصوت من الاستجابة.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `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 عند اكتمال المهمة. |

## FAQ

### ما نقاط نهاية 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 حرف.


## Links

- [دليل إعداد OpenClaw →](https://runapi.ai/ar/openclaw)
- [نماذج ElevenLabs →](https://runapi.ai/ar/models/elevenlabs)
- [Model catalog](https://runapi.ai/ar/models)
- [API docs](https://runapi.ai/ar/docs)