اكتشف قوة تحويل النص إلى كلام: 23 لغة، أسعار شفافة، وتكامل سهل

بواسطة فريق تحرير قصص صوتيًا · تم التحديث 2026-11-19

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

سيتعرف المطورون على دعمنا لـ 23 لغة، والأصوات الثمانية المتاحة، وهيكل الأسعار الشفاف، وآليات الدفع عبر USDT. كما نوضح معايير الخصوصية التي تضمن عدم استخدام نصوصك للتدريب، ونشرح التكامل السهل مع مكتبات OpenAI، مما يمنحك تحكماً كاملاً في الأصوات واللغات دون تعقيدات تقنية، لبناء مشاريع صوتية احترافية بسرعة وموثوقية.

اكتشف قوة تحويل النص إلى كلام: 23 لغة، أسعار شفافة، وتكامل سهل

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

ما هي اللغات التي تدعمها واجهة API؟

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

هل يمكنني استخدام مفتاح OpenAI SDK مع هذه الواجهة؟

نعم، الواجهة تستخدم نفس شكل طلبات واجهة OpenAI الصوتية. يمكنك استخدام مكتبات OpenAI الرسمية عن طريق تغيير base_url إلى https://api.qokl.info/v1 واستخدام مفتاح API الخاص بنا. هذا يسهل دمج الخدمة في تطبيقاتك الحالية بسرعة وسهولة.

ما هو سعر تحويل النص إلى كلام؟

السعر هو 10 دولارات أمريكية لكل مليون حرف (0.01 دولار لكل 1000 حرف). الطلبات الفاشلة مجانية ويتم إرجاع المبلغ بالكامل. يتوفر رصيد تجريبي بقيمة 0.50 دولار لمدة 7 أيام عند التسجيل عبر Google، ولا ينتهي رصيدك المدفوع.

كيف يمكنني إضافة الرصيد إلى حسابي؟

يتم الإيداع فقط عبر شبكة TRON (USDT TRC-20). الحد الأدنى للإضافة هو 5 دولارات. يتم اعتماد الرصيد تلقائيًا خلال دقائق. لا ندعم البطاقات أو PayPal أو الفواتير الضريبية. الرصيد لا ينتهي صلاحيته.

هل يتم احتساب المسافات والعلامات كحروف؟

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

ما هو الحد الأقصى لعدد الأحرف في الطلب الواحد؟

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

هل يتم تخزين الملفات الصوتية المولدة؟

لا، يتم إرجاع الملف الصوتي في الاستجابة ولا يتم تخزينه. النص المدخل يُستخدم فقط لإنتاج الصوت ولا يُستخدم للتدريب. نحتفظ فقط ببيانات الطلب (الوقت، عدد الأحرف، الحالة) لأغراض الفوترة والتدقيق.

كيف تعمل واجهة API

رسم توضيحي لموجة الصوت لـ: كيف تعمل واجهة API

واجهة برمجة التطبيقات الخاصة بـ "قصص صوتيًا" مصممة لتبسيط تحويل النصوص إلى ملفات صوتية عالية الجودة، مما يتيح لمطوري التطبيقات المستقلين دمج القدرات الصوتية في تطبيقاتهم بسهولة. تعتمد الواجهة على نموذج بسيط: إرسال النص عبر طلب POST واستقبال ملف صوتي جاهز للاستخدام مباشرة.

نموذج الطلب والاستجابة

نموذج الطلب والاستجابة

إرسال نصك إلى نقطة النهاية POST https://api.qokl.info/v1/audio/speech مع تحديد النموذج (tts-1 أو tts-1-hd) والصوت المفضل. ستحصل على ملف صوتي مباشرة في الاستجابة، ويمكن استخدام مكتبات OpenAI SDK المعروفة بتعديل عنوان الخادم الأساسي (base_url).

نقاط النهاية الرئيسية

نقاط النهاية الرئيسية

بالإضافة إلى نقطة توليد الصوت، توفر الواجهة GET /v1/voices للاطلاع على قائمة الأصوات واللغات المتاحة، وGET /v1/models لمعرفة النماذج الحالية.

معالجة النصوص الطويلة

معالجة النصوص الطويلة

للنصوص التي تتجاوز 4096 حرفًا، قم بتقسيم النص إلى أجزاء متساوية الحجم، ثم اجمع الملفات الصوتية الناتجة يدويًا للحصول على القصة الكاملة.

سرعة التوليد المتوقعة

سرعة التوليد المتوقعة

يتم معالجة الطلبات بالتتابع. النصوص الطويلة تولد بسرعة تقارب الزمن الحقيقي (25 حرفًا في الثانية)، بينما قد تستغرق الجمل القصيرة بضع ثوانٍ.

اللغات والأصوات المدعومة

رسم توضيحي لموجة الصوت لـ: اللغات والأصوات المدعومة

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

دعم 23 لغة متنوعة

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

  • العربية، الصينية، الدنماركية، الهولندية، الإنجليزية
  • الفنلندية، الفرنسية، الألمانية، اليونانية، العبرية
  • الهندية، الإيطالية، اليابانية، الكورية، الملايوية
  • النرويجية، البولندية، البرتغالية، الروسية، الإسبانية
  • السواحيلية، السويدية، التركية

الأصوات الثمانية المتاحة

تتوفر ثماني أصوات محددة مسبقاً تناسب سياق القصص والحكايات: آريا (سرد واضح)، نيفا (مبهجة)، لونا (حكايات هادئة)، وساج (تعليمي). كما تتضمن القائمة ميلو (حواري ودود)، أتلاس (محايد)، أوريون (وثائقي عميق)، وفليكس (ديناميكي).

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

مصادر الأصوات المرخصة

هذه الأصوات مبنية على تسجيلات مرخصة من مكتبة LibriVox العامة.

العلامة المائية الصوتية

يحتوي كل ملف صوتي يتم إنشاؤه على علامة مائية غير مسموعة، مما يوضح بوضوح أن المحتوى صوتي اصطناعي.

الأسعار وطرق الدفع

رسم توضيحي لموجة الصوت لـ: الأسعار وطرق الدفع

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

هيكل الأسعار الشفاف

تكلفة الخدمة هي 10 دولارات لكل مليون حرف، أي ما يعادل 0.01 دولار لكل 1000 حرف. يتم احتساب المسافات والعلامات النحوية ضمن عدد الأحرف المحسوبة. لا توجد حد أدنى للإنفاق أو رسوم اشتراك شهرية.

تجربة مجانية لمدة 7 أيام

عند التسجيل عبر حساب Google، تحصل تلقائيًا على رصيد تجريبي بقيمة 0.50 دولار (حوالي 50,000 حرف). يستمر هذا الرصيد لمدة 7 أيام من لحظة التسجيل. الحسابات المسجلة بالبريد الإلكتروني لا تحصل على رصيد تجريبي.

شحن الرصيد عبر USDT

يمكنك شحن الرصيد باستخدام عملة USDT على شبكة TRON (TRC-20). الحد الأدنى للإيداع هو 5 دولارات، ويتم إضافة الرصيد تلقائيًا خلال دقائق. لا ندعم البطاقات الائتمانية أو PayPal أو الفواتير.

استرداد المبالغ الفاشلة

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

إدارة الحساب والمفتاح

رسم توضيحي لموجة الصوت لـ: إدارة الحساب والمفتاح

تبدأ رحلتك بإنشاء حساب عبر صفحة /get-api-key/ باستخدام حساب Google أو البريد الإلكتروني. كل حساب مرتبط بموقع مستقل، مما يضمن عزل بياناتك. بعد التسجيل، تصبح جاهزًا لاستخراج مفتاح API الخاص بك وبدء الاختبارات فورًا.

إنشاء الحساب وتسجيل الدخول

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

إدارة مفاتيح API

يحتوي كل حساب على مفتاح نشط واحد (يبدأ بـ tts-...). يمكنك إصدار مفتاح جديد في أي وقت، مما يوقف المفتاح القديم فورًا. هذا يسهل إعادة التدوير عند فقدان المفتاح أو تغيير الأجهزة.

حدود الاستخدام والسرعة

الحد القياسي هو 60 طلبًا في الدقيقة لكل مفتاح (10 طلبات في الدقيقة قبل أول شحن رصيد). هذا يضمن استقرار الخدمة عند الطلبات المتزامنة.

لوحة التحكم والميزانية

الصفحة الرئيسية تعرض المفتاح، الرصيد، رصيد التجربة المتبقي، عدد الأحرف، وسجل الاستخدام. كما توفر مثال curl جاهزًا للتجربة. الرصيد لا ينتهي، ولا توجد رسوم شهرية.

إدارة الحساب والمفتاح

التكامل التقني

رسم توضيحي لموجة الصوت لـ: التكامل التقني

تكامل بسيط وسريع يتيح لك استخدام مكتبات OpenAI المعروفة مع واجهتنا. كل ما عليك هو تغيير عنوان الخادم الأساسي (base_url) إلى https://api.qokl.info/v1 واستخدام مفتاح API الخاص بك. هذا يجعل الانتقال من أي نظام آخر سهلاً ومباشرًا.

التوافق مع OpenAI SDK

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

  • غيّر base_url إلى https://api.qokl.info/v1
  • استخدم مفتاح API الخاص بك في رأس الطلب

تنسيقات الصوت المدعومة

اختر التنسيق الأنسب لتطبيقك من بين خيارات متعددة. ندعم mp3، wav، opus، flac، و pcm لضمان التوافق مع معظم مشغلات الوسائط وأنظمة التشغيل.

ضبط سرعة الصوت

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

تحديد اللغة تلقائياً

تحدد API اللغة تلقائياً بناءً على النص المدخل، مع افتراض الإنجليزية للنصوص اللاتينية. يمكنك تحديد رمز ISO صراحةً لضمان الدقة، خاصة للنصوص غير الإنجليزية.

البيانات والخصوصية

رسم توضيحي لموجة الصوت لـ: البيانات والخصوصية

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

استخدام النص للتوليد فقط

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

عدم تخزين الملفات الصوتية

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

بيانات الفوترة والميزانية

نحتفظ فقط بالبيانات الوصفية (Metadata) اللازمة للفوترة، مثل: وقت الطلب، عدد الأحرف المستخدمة، وحالة الطلب (نجاح أو فشل). هذه البيانات ضرورية فقط لحساب الرصيد بدقة وإصدار كشف الحساب عند الحاجة.

عدم استخدام البيانات للتدريب

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

استمع إلى الأصوات الثمانية

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

صورة رمزية للصوت aria
ariaأنثى
صورة رمزية للصوت nova
novaأنثى
صورة رمزية للصوت luna
lunaأنثى
صورة رمزية للصوت sage
sageأنثى
صورة رمزية للصوت felix
felixذكر
صورة رمزية للصوت milo
miloذكر
صورة رمزية للصوت atlas
atlasذكر
صورة رمزية للصوت orion
orionذكر

23 لغة

يمكن لأي صوت التحدث بأي من هذه اللغات.

المصادر ومزيد من القراءة

  1. Wikipedia
  2. Python documentation
  3. OpenAI API reference: create speech
  4. IETF RFC 7845: Ogg Opus
  5. TRON developer hub: TRC-20
  6. LibriTTS-R paper (arXiv 2305.18802)
  7. W3C WAI: making audio and video accessible
  8. Node.js documentation
  9. Tether (USDT)
  10. MDN: Web Speech API
  11. openai-node on GitHub
  12. openai-python on GitHub

المزيد في هذا الموقع