منصة همسة الإعلامية · واجهة برمجة التطبيقات (API)

واجهة برمجة التطبيقات (API) لمنصة همسة الإعلامية

استفد من المحرك نفسه الذي يشغّل استوديو همسة الإعلامي، مباشرةً عبر واجهة برمجة التطبيقات (API). أرسل الملفات الصوتية لتفريغها إلى نصوص، وحوّل النصوص إلى كلام طبيعي، واستخدم الذكاء الاصطناعي لإنشاء محتوى جديد انطلاقًا من النصوص المفرّغة. يمكنك أيضًا متابعة حالة كل مهمة، واستعراض نتائجها وإدارتها بالكامل من خادمك، دون الحاجة إلى استخدام واجهة الاستوديو.

  • مهام تحويل الكلام إلى نص
  • مهام تحويل النص إلى كلام
  • توليد محتوى ذكي من النصوص باستخدام الذكاء الاصطناعي
  • تسليم النتائج تلقائيًا عبر Webhook
  • إدارة متكاملة للمهام ومتابعة حالاتها ونتائجها

الإمكانات

جميع وظائف الاستوديو عبر واجهة برمجة التطبيقات (API)

01

تحويل الملفات الصوتية والمرئية إلى نصوص عبر الرابط

أرسل رابط ملف صوتي أو فيديو مستضاف إلى واجهة التفريغ الصوتي، لتحصل على نص مفرّغ يتضمّن طوابع زمنية وتحديدًا للمتحدثين، مع إمكانية إنشاء ملفات ترجمة بصيغة SRT عند الطلب.

02

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

تتيح واجهة مهام توليد الصوت تحويل النصوص إلى كلام طبيعي، مع إمكانية اختيار الصوت واللهجة المناسبين لاحتياجاتك، بما في ذلك الأصوات المخصّصة التي أنشأتها باستخدام تقنية استنساخ الصوت.

03

إنشاء محتوى ذكي من النصوص المفرّغة

حوّل النصوص المفرّغة من الملفات الصوتية والمرئية إلى محتوى منظّم باستخدام الذكاء الاصطناعي، من خلال قوالب جاهزة أو تعليمات مخصّصة تحدّدها وفق احتياجاتك، عبر واجهات توليد المحتوى الذكي.

04

تقدير التكلفة قبل تنفيذ المهمة

تتيح لك واجهة تقدير التكلفة معرفة التكلفة المتوقعة لمهام توليد المحتوى الذكي قبل تنفيذها، ما يساعدك على التخطيط لميزانيتك والتحكم في النفقات واتخاذ قرارات مدروسة بشأن تشغيل المهام.

05

إدارة متكاملة للمهام

تحكّم في مهام الاستوديو مباشرةً عبر واجهة برمجة التطبيقات (API)، بدءًا من استعراض قائمة المهام ومتابعة حالة كل مهمة ونتائجها، وصولًا إلى تحديثها أو حذفها. وتتيح لك الواجهة الوصول إلى سجل المهام وإدارته بالكامل دون الحاجة إلى استخدام واجهة الاستوديو.

06

تسليم تلقائي للنتائج عبر Webhook

استلم نتائج المهام تلقائيًا على خادمك من خلال تحديد عنوان webhookUrl، مع إمكانية تفعيل المصادقة لتعزيز الأمان. ويمكنك أيضًا الاستعلام عن حالة المهمة ونتائجها باستخدام معرّفها الفريد، بما يتيح لك اختيار آلية استلام النتائج الأنسب لسير عمل تطبيقك.

التكامل

أنشئ سير عمل متكاملًا لإنتاج المحتوى الإعلامي عبر واجهة برمجة التطبيقات (API)

تعرّف على خطوات معالجة المحتوى الصوتي والمرئي عبر واجهة برمجة التطبيقات (API)، بدءًا من إرسال الملفات وحتى استلام النتائج والاستفادة منها.

  1. 01

    أنشئ مفتاحًا سريًا

    أنشئ مفتاحًا سريًا من لوحة تحكم همسة واحفظه على خادمك، ثم أرفقه مع كل طلب عبر ترويسة Authorization بالصيغة Token <key>.

  2. 02

    أرسل الملفات الصوتية والمرئية

    أرسل رابط الملف عبر طلب POST إلى واجهة التفريغ الصوتي، مع تحديد النموذج واللغة المطلوبة. تُضاف المهمة إلى قائمة انتظار وتُعالَج بشكل غير متزامن.

  3. 03

    استلم النص المفرّغ

    استقبل نتائج التفريغ تلقائيًا عبر Webhook، أو استعلم عن حالة المهمة ونتائجها باستخدام معرّفها الفريد. تتضمّن النتائج مقاطع نصية مرتبطة بطوابع زمنية، مع تحديد المتحدثين وإمكانية الحصول على ملفات ترجمة بصيغة SRT عند الطلب.

  4. 04

    أنشئ محتوى جديدًا من النتائج

    حوّل النصوص المفرّغة إلى ملخصات ومستندات منظّمة باستخدام واجهات توليد المحتوى الذكي، أو استخدم واجهة مهام تحويل النص إلى كلام لإنتاج محتوى صوتي طبيعي بالصوت واللهجة اللذين تختارهما.

  5. 05

    أدر مهامك بكفاءة

    استعرض جميع المهام وتابع حالاتها، واطّلع على نتائج كل مهمة باستخدام معرّفها الفريد. يمكنك أيضًا تحديث العناوين والبيانات الوصفية أو حذف المهام التي لم تعد بحاجة إليها، لضمان تنظيم سير العمل وإدارة المحتوى بكفاءة.

المرجع

مرجع سريع لواجهة برمجة التطبيقات (API) لمنصة همسة الإعلامية

يرتبط كل قسم بصفحته في التوثيق الرسمي لواجهة برمجة التطبيقات (API)، حيث يمكنك الاطّلاع على التفاصيل التقنية الكاملة، وبنية الطلبات والاستجابات، وأمثلة شيفرة جاهزة للتنفيذ، لتسهيل عملية التكامل مع منصة همسة الإعلامية.

المجالالتفاصيل
تحويل الكلام إلى نص (STT)أرسل رابط ملف صوتي أو مرئي مستضاف، واحصل على نص مفرّغ يتضمّن طوابع زمنية وتحديدًا للمتحدثين، مع إمكانية إنشاء ملفات ترجمة بصيغة SRT عند الطلب.
تحويل النص إلى كلام (TTS)حوّل النصوص إلى كلام طبيعي بالصوت واللهجة اللذين تختارهما، عبر مهام تُعالَج بشكل غير متزامن، مع إمكانية استلام الملفات الصوتية الناتجة تلقائيًا عند اكتمال التوليد.
توليد المحتوى الذكيحوّل النصوص المفرّغة إلى محتوى منظّم باستخدام الذكاء الاصطناعي، من خلال قوالب جاهزة أو تعليمات مخصّصة تحدّدها وفق احتياجاتك.
تقدير التكلفةتعرّف على التكلفة المتوقعة لمهام توليد المحتوى الذكي قبل تنفيذها، لتخطيط ميزانيتك والتحكم في النفقات بكفاءة.
إنشاء محتوى من النصوص المفرّغةولّد محتوى ذكيًا مباشرةً من مهام التفريغ الصوتي المكتملة، باستخدام الذكاء الاصطناعي لتحويل النصوص إلى محتوى منظّم وجاهز للاستخدام.
إدارة المهاماستعرض قائمة المهام، وتابع حالة كل مهمة ونتائجها، مع إمكانية تحديث بياناتها أو حذفها حسب الحاجة.
تسليم النتائجاستلم نتائج المهام تلقائيًا عبر Webhook مع إمكانية تفعيل المصادقة لكل مهمة، أو استعلم عن حالتها ونتائجها باستخدام معرّف المهمة الفريد.
النماذج والأصوات المدعومةاستخدم نموذجي Hamsa-General-V2.0 وHamsa-Conversational-V1.0 لتحويل الكلام إلى نص، واختر من مكتبة الأصوات المتاحة أو استخدم أصواتك المخصّصة بتقنية استنساخ الصوت لتحويل النص إلى كلام.
المصادقةمفتاح سري في ترويسة Authorization مع كل طلب، بالصيغة Token <key>.

حالات الاستخدام

كيف تستفيد الفرق من واجهة برمجة التطبيقات (API) لمنصة همسة الإعلامية

01

التفريغ التلقائي للمحتوى عند النشر

حوّل الحلقات الصوتية ومقاطع الفيديو الجديدة إلى نصوص تلقائيًا بمجرد نشرها، ثم أدمج النصوص المفرّغة في نظام إدارة المحتوى (CMS) إلى جانب الملفات الأصلية، لتسهيل أرشفتها وتنظيمها وإعادة استخدامها.

02

إنشاء ملفات الترجمة تلقائيًا

أنشئ ملفات ترجمة بصيغة SRT تلقائيًا لكل فيديو يُضاف إلى مكتبة المحتوى، مع طوابع زمنية دقيقة ومزامنة مع الكلام، دون الحاجة إلى تدخل يدوي أو استخدام أدوات تحرير منفصلة.

03

إعادة توظيف المحتوى باستخدام الذكاء الاصطناعي

حوّل الندوات والجلسات المسجّلة إلى ملخصات ومقالات ومنشورات لوسائل التواصل الاجتماعي، باستخدام واجهات توليد المحتوى الذكي. انطلق من مهمة تفريغ صوتي واحدة لإنشاء محتوى متنوع وجاهز للاستخدام عبر قنوات متعددة.

04

توليد التعليقات الصوتية باللغة العربية

حوّل النصوص ضمن سير عمل التعريب إلى تعليقات صوتية طبيعية باللهجة العربية المناسبة لجمهورك، مع إمكانية استلام الملفات الصوتية الناتجة تلقائيًا عبر Webhook وتخزينها في أنظمتك، لتسهيل دمجها في المحتوى الإعلامي والفيديوهات.

الأسئلة الشائعة

الأسئلة الشائعة حول واجهة برمجة التطبيقات (API) لمنصة همسة الإعلامية

ما الفرق بين واجهة برمجة التطبيقات (API) واستوديو همسة الإعلامي؟

+

يعتمد كلاهما على المحرك التقني نفسه، لكنهما يوفّران طريقتين مختلفتين للوصول إلى إمكانات المنصة. يتيح استوديو همسة الإعلامي للمستخدمين تنفيذ مهام التفريغ الصوتي وتحويل النص إلى كلام وتوليد المحتوى الذكي عبر واجهة ويب تفاعلية. أما واجهة برمجة التطبيقات (API)، فتتيح للمطوّرين دمج الإمكانات نفسها مباشرةً في تطبيقاتهم وأنظمتهم، وأتمتة تنفيذ المهام وإدارتها واستلام نتائجها من خوادمهم، دون الحاجة إلى استخدام واجهة الاستوديو.

كيف يتم تسليم نتائج المهام؟

+

يمكنك استلام نتائج المهام تلقائيًا عبر Webhook، من خلال تحديد عنوان webhookUrl عند إنشاء المهمة، مع إمكانية تفعيل المصادقة لتعزيز الأمان. وبمجرد اكتمال المعالجة، تُرسل النتائج إلى العنوان المحدّد. وإذا كنت تفضّل الاستعلام المباشر، يمكنك متابعة حالة المهمة واسترجاع نتائجها باستخدام معرّفها الفريد.

ما نوع المحتوى الذي يمكن إنشاؤه عبر واجهات توليد المحتوى الذكي؟

+

تتيح لك واجهات توليد المحتوى الذكي تحويل النصوص المفرّغة من المهام المكتملة إلى محتوى مكتوب ومنظّم، باستخدام قوالب جاهزة أو تعليمات مخصّصة تحدّدها عبر نقطة النهاية ‎/custom. كما يمكنك تقدير تكلفة توليد المحتوى مسبقًا باستخدام نقطة النهاية ‎/estimate، قبل تنفيذ المهمة.

هل يمكنني استخدام الأصوات المستنسخة في مهام تحويل النص إلى كلام؟

+

نعم، يمكنك إنشاء صوت مخصّص باستخدام واجهة استنساخ الصوت، ثم تحميله مسبقًا لمرة واحدة لاستخدامه في مهام تحويل النص إلى كلام. بعد ذلك، ما عليك سوى تمرير معرّف الصوت الفريد عبر المعامل voiceId عند إنشاء المهمة، لتوليد المحتوى الصوتي بالصوت المستنسخ الذي اخترته.

كيف تتم المصادقة على طلبات واجهة برمجة التطبيقات (API)؟

+

تتم المصادقة باستخدام مفتاح سري تُنشئه من لوحة تحكم همسة، ثم تُرفقه مع كل طلب في ترويسة Authorization بالصيغة Token <key>. ولا يُعرض المفتاح إلا مرة واحدة، ويُرفض إن أُرسل من متصفح، فاحفظه على خادمك. ويرتبط كل مفتاح بمشروع محدّد، بحيث تُنشأ المهام وتُدار تلقائيًا ضمن المشروع المرتبط بالمفتاح المستخدم.

تابع القراءة

واجهة همسة البرمجية (API) · تحويل الكلام إلى نص (STT)

واجهة همسة البرمجية (API) لتحويل الكلام إلى نص (STT)

حوّل الكلام العربي بمختلف لهجاته إلى نص عبر المعالجة الدفعية أو الفورية أو البث المباشر، مع طوابع زمنية دقيقة لكل كلمة، وتمييز المتحدثين، وإمكانية تصدير ملفات الترجمة بصيغة SRT.

اقرأ ←

واجهة همسة البرمجية (API) · تحويل النص إلى كلام (TTS)

واجهة برمجة التطبيقات لتحويل النص إلى كلام عربي (TTS)

حوّل النصوص إلى كلام طبيعي عبر 14 لهجة عربية، بالإضافة إلى الإنجليزية، مع دعم التوليد الفوري والمعالجة غير المتزامنة والبث الصوتي المباشر، ومخرجات متوافقة مع أنظمة الاتصالات الهاتفية، وإمكانية استخدام أصوات مستنسخة ومخصّصة.

اقرأ ←

واجهة همسة البرمجية (API) · استنساخ الصوت

واجهة برمجة التطبيقات (API) لاستنساخ الصوت

أنشئ أصواتًا مخصّصة بالذكاء الاصطناعي باللغتين العربية والإنجليزية انطلاقًا من عيّناتك الصوتية، مع إمكانية معاينتها وإدارتها بالكامل عبر واجهة REST API. واستخدم الأصوات المستنسخة عبر مختلف حلول همسة، بما في ذلك تحويل النص إلى كلام (TTS)، والوكلاء الصوتيون، ومنصة همسة الإعلامية، للحفاظ على هوية صوتية موحّدة عبر جميع قنوات التواصل.

اقرأ ←

منظومة الشركاء

شراكات موثوقة
ضمن منظومة التقنية

تتعاون همسة مع كبرى شركات التقنية، وشركات تكامل الأنظمة، ومزوّدي الحلول، لتقديم حلول الذكاء الاصطناعي الصوتي للمؤسسات على نطاق واسع في مختلف أنحاء المنطقة.