أضافت Runway نموذج Eleven v4 إلى واجهة المطورين في 30 سبتمبر. وتحدد ملاحظة الإصدار النموذج على أنه eleven_v4، وتضع حدًا للنص يبلغ 2,500 حرف، وتقول إن معدل الأرصدة سيرتفع في 12 أكتوبر 2026 بتوقيت المحيط الهادئ. بالنسبة إلى المطورين الذين يضيفون توليد الكلام إلى سير عمل إنتاجي، يتمثل السؤال العملي في متطلبات الطلب الصحيح وما يعادله السعر الموثق بالدولار. يستند هذا الدليل إلى وثائق Runway التي جرى التحقق منها في 6 أكتوبر؛ ولم تُجر BIG CHANGE طلبًا مدفوعًا عبر الواجهة أو تقيّم الصوت.

التغيير الأهم

  • ما الذي تغيّر: تعرض Runway الآن Eleven v4 نموذجًا لتحويل النص إلى كلام عبر واجهة المهام الحالية. ويمكن أن يتضمن النص علامات صوتية موثقة مثل [laughs] و[whispers] و[pause] ضمن حد 2,500 حرف.
  • لماذا يهم ذلك: يستطيع فريق لديه مشروع مطورين في Runway طلب كلام بصوت مُعد مسبقًا واسترداد عنوان URL للصوت الناتج عن المهمة المكتملة. وبذلك يمكن أن يستند التخطيط للتكامل والميزانية إلى صيغة طلب موثقة وجدول أسعار محدد التاريخ.
  • ما ينبغي مراقبته: تقول Runway إن المعدل سيتغير من 2.2 إلى 5 أرصدة لكل 1,000 حرف في 12 أكتوبر 2026 بتوقيت المحيط الهادئ. وينبغي لمن يقدّر كلفة التوليد المتكرر استخدام المعدل الساري عند فوترة الطلب والتحقق من السعر الحالي قبل اعتماد الميزانية.

إعداد مشروع ومفتاح

توصي إرشادات الإعداد لدى Runway بإنشاء حساب ومشروع في بوابة المطورين، ثم إنشاء مفتاح API للمشروع ضمن API Keys. يتطلب إنشاء المفتاح أو تعطيله دور Admin أو Developer. ويظهر المفتاح مرة واحدة كنص واضح، لذا ينبغي حفظه بأمان. ولاستخدام SDK، تقول Runway بإعداد RUNWAYML_API_SECRET؛ إذ يقرأ SDK هذا المتغير تلقائيًا. أبقِ السر خارج الشيفرة المصدرية.

يحتاج المشروع أيضًا إلى أرصدة قبل استخدام الواجهة. وتقول Runway إن الحد الأدنى للدفع الأولي هو $10, بسعر $0.01 لكل رصيد, من علامة الفوترة في المشروع. ويتطلب إضافة الأرصدة دور Admin أو Billing admin. وهذا حد أدنى لشراء الأرصدة، لا رسوم طلب كلام واحد. ولا تصف صفحة الإعداد أول طلب مجاني.

إرسال طلب لتحويل النص إلى كلام

يتطلب نوع الطلب الحالي في Runway Python SDK الحقول model، prompt_text و voice كائن لنموذج Eleven v4. وعلى مستوى النقل، تقابلها حقول JSON model، promptText و voice، مع voice.type يُضبط على runway-preset واستخدام كائن presetId. Bernard أحد الأصوات المعدة مسبقًا والمدرجة. وترسل خدمة SDK هذا الطلب إلى /v1/text_to_speech وتعيد استجابة بمهمة جديدة. وتوضح Runway إرشادات API المضيف ومفتاح bearer والترويسة X-Runway-Version: 2024-11-06 المستخدمة في طلبات HTTP المباشرة.

هذا متن طلب مستمد من الوثائق، وليس طلبًا نفذناه:

JSON
{
  "model": "eleven_v4",
  "promptText": "The recording begins now. [pause] Welcome.",
  "voice": {
    "type": "runway-preset",
    "presetId": "Bernard"
  }
}

يسرد مدخل سجل التغييرات في 30 سبتمبر لدى Runway كلًا من [laughs]، [whispers] و [pause] أمثلةً مدعومة، ويقول إن Eleven v4 يستخدم الأصوات المُعدة مسبقًا نفسها في Runway التي يستخدمها Eleven v3. العلامات جزء من النص، لذا اترك لها مساحة ضمن الحد الأقصى المعلن، وهو 2,500 حرف. كما يسرد SDK إعدادات اختيارية للصوت واللغة وحقول النص المجاورة. ولا يثبت المخطط أن أي إعداد يضمن طريقة إلقاء معينة، ولا يقدم هذا المقال ادعاءً عن جودة الصوت أو زمن الاستجابة.

الاستجابة الأولى مهمة وليست بيانات صوتية. وتوصي Runway بـ إرشادات المخرجات للاستعلام عن GET /v1/tasks/:id؛ وتتضمن المهمة الناجحة مصفوفة output لعناوين URL للنتائج. تنتهي صلاحية هذه العناوين خلال 24–48 ساعة من الوصول إلى API، لذا نزّل النتيجة إلى مساحة التخزين الخاصة بك بدل استخدام الرابط المؤقت في منتج. والمثال العام للمخرجات يخص مهمة فيديو ويبين بنية استجابة المهمة، بينما تحدد قائمة النماذج خرج Eleven v4 على أنه صوت. لم نرَ استجابة من Eleven v4 ولم نتحقق من تنسيق ملف الصوت.

حساب السعر وفق التاريخ

تسرد Runway صفحة الأسعار وملاحظة الإصدار معدل 2.2 رصيدًا لكل 1,000 حرف حتى 12 أكتوبر 2026 بتوقيت المحيط الهادئ، ثم 5 أرصدة لكل 1,000 حرف، مع حد أدنى رصيد واحد. وبالسعر المنشور، أي $0.01 لكل رصيد، يعادل المعدلان $0.022 و $0.05 لكل 1,000 حرف، قبل أي ضريبة واجبة. والمعدل اللاحق أعلى بنحو 2.27 مرة من السابق.

مثال تخطيط واضح: عشرة نصوص منفصلة، طول كل منها 1,000 حرف قابل للفوترة بالضبط، يبلغ مجموعها 10,000 حرف. وضرب هذا العدد في الأسعار المنشورة يعطي 22 رصيدًا، أو $0.22، بالمعدل السابق و 50 رصيدًا، أو $0.50، بالمعدل اللاحق. وكل نص دون حد 2,500 حرف، وكل طلب محسوب فوق الحد الأدنى البالغ رصيدًا واحدًا. هذه عملية حسابية مبنية على الأسعار المنشورة من Runway وليست فاتورة فعلية. ولا تحدد الصفحات المذكورة كيفية احتساب العلامات ضمن الأحرف المفوترة أو ما إذا كانت الرسوم الجزئية لكل طلب تُقرّب؛ لذلك ينبغي لمقدّر الإنتاج التحقق من سجلات الاستخدام الفعلية والشروط الحالية.

المصادر وقراءات إضافية

يثبت سجل تغييرات API لدى Runway بتاريخ 30 سبتمبر تاريخ الإطلاق ومعرّف النموذج وأمثلة العلامات وحد النص والسعر المحدد التاريخ. وتشرح إرشادات الإعداد متطلبات المشروع والمفتاح والأرصدة، بما فيها صلاحيات الأدوار والدفع الأولي البالغ $10. وتوفر صفحة الأسعار تحويل الأرصدة إلى دولارات والأسعار المدرجة لـ Eleven v4.

ويحدد مخطط طلب Python SDK وتنفيذ الخدمة أسماء الحقول وصيغة الصوت المعد مسبقًا ومسار نقطة النهاية واستجابة إنشاء المهمة التي فُحصت لهذا الدليل. وتوفر Runway إرشادات البدء، قائمة النماذج و إرشادات المخرجات ترويسة إصدار HTTP وتصنيف خرج الصوت وسلوك استرجاع المهام. هذه وثائق من المورّد وليست اختبار أداء مستقلًا. تم التحقق منها في 6 أكتوبر 2026.