الأسئلة الشائعة
ما هي اللغات المدعومة في واجهة API؟
ندعم 23 لغة تشمل العربية، الإنجليزية، الصينية، الفرنسية، الألمانية، الإسبانية، الروسية، والهندية، وغيرها. يمكن لأي صوت نطق أي من هذه اللغات. إذا لم تحدد لغة، سيتم تخمينها تلقائيًا، لذا يُنصح بتحديدها يدويًا للنصوص غير الإنجليزية. اللغات غير المدعومة تشمل الفيتنامية والتايلاندية والأوكرانية.
كيف يتم حساب التكلفة؟
التكلفة هي 10 دولارات أمريكية لكل مليون حرف، أي 0.01 دولار لكل 1000 حرف. يتم احتساب المسافات وعلامات الترقيم ضمن عدد الأحرف. الطلبات الفاشلة مجانية ويتم إرجاع المبلغ بالكامل في حال فشل عملية التوليد. الرصيد لا ينتهي بمرور الوقت.
ما هي طرق الدفع المتاحة؟
نقبل الدفع عبر USDT على شبكة TRON (TRC-20) فقط. الحد الأدنى للإيداع هو 5 دولارات أمريكية. يتم اعتماد الرصيد تلقائيًا خلال دقائق من التحويل. لا نقبل البطاقات أو PayPal أو الاشتراكات الشهرية أو الفواتير الضريبية. لا توجد خطط شهرية أو حد أدنى للإنفاق.
هل هناك تجربة مجانية؟
نعم، عند التسجيل عبر حساب Google، تحصل على رصيد تجريبي بقيمة 0.50 دولار، بما يكفي لحوالي 50,000 حرف، لمدة 7 أيام. الحسابات المسجلة بالبريد الإلكتروني وكلمة المرور تبدأ بدون رصيد تجريبي. هذا الرصيد مخصص لتجربة الواجهة قبل الشراء.
ما هي حدود معدل الطلب؟
الحد هو 60 طلبًا في الدقيقة لكل مفتاح API. قبل أول إيداع، يكون الحد 10 طلبات في الدقيقة فقط. يتم معالجة الطلبات بالتسلسل، مما قد يؤدي إلى طوابير الانتظار تحت الضغط. النصوص الأطول تُقسم إلى أجزاء لا تتجاوز 4096 حرفًا لكل طلب.
هل يمكنني استخدام مكتبات OpenAI؟
نعم، واجهتنا متوافقة تمامًا مع مكتبات OpenAI الرسمية. يمكنك استخدام نفس شكل الطلبات، مع تغيير base_url إلى https://api.qokl.info/v1 واستخدام مفتاحك الخاص. تدعم النماذج tts-1 و tts-1-hd بنفس المحرك والسعر. هذا يسهل دمج الخدمة في مشاريعك الحالية بسرعة.
هل يتم تخزين النص المدخل؟
يتم استخدام النص المدخل فقط لإنتاج ملف الصوت ولا يُستخدم لتدريب النماذج. ملف الصوت الناتج يُرجع في الاستجابة ولا يتم تخزينه على خوادمنا. نحتفظ ببيانات الطلب (الوقت، عدد الأحرف، الحالة) لأغراض الفوترة فقط، دون الاحتفاظ بالنص الأصلي أو الصوت النهائي.
ما هي الأصوات المتاحة؟
نوفر 8 أصوات مخصصة: Aria و Nova و Luna و Sage للإناث، و Felix و Milo و Atlas و Orion للذكور. كل صوت يدعم جميع اللغات المدعومة. الأصوات مبنية على تسجيلات مرخصة من LibriVox. كل ملف صوتي يحتوي على علامة مائية غير مرئية تدل على كونه speech اصطناعي.
هل هناك دعم للهواتف المحمولة؟
لا توجد مكتبة مخصصة للهواتف المحمولة (Mobile SDK) ولا تطبيق مخصص. يمكنك استخدام واجهة RESTful القياسية أو مكتبات HTTP العامة من أي جهاز. الواجهة مصممة لتعمل عبر الإنترنت، ويمكنك دمجها في تطبيقاتك باستخدام أي لغة برمجة تدعم إرسال طلبات HTTP.
كيف يتم إصدار مفتاح API جديد؟
يمكنك إصدار مفتاح جديد في أي وقت من لوحة التحكم الخاصة بحسابك. عند إصدار مفتاح جديد، يتوقف المفتاح القديم فورًا عن العمل. لديك مفتاح نشط واحد فقط لكل حساب. يمكنك استخدام المفتاح الجديد في طلباتك الجديدة دون الحاجة لإعادة التكوين المعقد.
واجهة برمجة التطبيقات الصوتية السحابية
واجهة برمجة التطبيقات الصوتية السحابية مصممة لتبسيط عملية تحويل النصوص إلى ملفات صوتية عالية الجودة. تعتمد على بنية بسيطة تعتمد على طلبات HTTP القياسية، مما يسهل دمجها مع تطبيقات الأطفال والحكايات دون الحاجة إلى خوادم معقدة.
تتطلب العملية فقط إرسال النص المطلوب عبر واجهة POST مع تحديد النموذج والصوت المفضل، لتعود الاستجابة بملف صوتي جاهز للاستخدام مباشرة في التطبيقات.
كيف تعمل واجهة API
تبدأ العملية بإرسال نصك إلى نقطة النهاية https://api.qokl.info/v1/audio/speech عبر بروتوكول HTTP. يجب أن يحتوي الطلب على الحقل input للنص (حتى 4096 حرفاً)، وحقل model المحدد بـ "tts-1" أو "tts-1-hd"، بالإضافة إلى تحديد voice المناسب للقصة.
بعد استلام الطلب، تقوم الخوادم بمعالجة النص وإنتاج ملف صوتي بصيغة mp3 أو wav حسب اختيارك. يتم إرجاع الملف مباشرة في جسم الاستجابة، مما يتيح لك حفظه أو تشغيله فوراً في تطبيقك دون خطوات وسيطة معقدة.
إذا كان النص الطويل يتجاوز الحد المسموح، عليك تقسيمه إلى أجزاء لا تتجاوز 4096 حرفاً، ثم دمج الملفات الصوتية الناتجة يدوياً في تطبيقك للحصول على القصة الكاملة.
- نقطة النهاية:
POST https://api.qokl.info/v1/audio/speech - النموذج: "tts-1" أو "tts-1-hd"
- الحجم الأقصى للنص: 4096 حرفاً لكل طلب
اللغات المدعومة
تتيح واجهة برمجة التطبيقات دعم 23 لغة متنوعة، مما يمنح مطوري التطبيقات المستقلين مرونة كبيرة في إنتاج قصص الأطفال وحكايات الأطفال بلغات متعددة بدقة عالية. يمكنك إرسال النص مع تحديد رمز اللغة (ISO code) لضمان النطق الصحيح، خاصة للنصوص المكتوبة بالحروف اللاتينية غير الإنجليزية التي لا يتم افتراضها تلقائياً.
اللغات المدعومة تشمل: العربية، الصينية، الدنماركية، الهولندية، الإنجليزية، الفنلندية، الفرنسية، الألمانية، اليونانية، العبرية، الهندية، الإيطالية، اليابانية، الكورية، الماليزية، النرويجية، البولندية، البرتغالية، الروسية، الإسبانية، السواحيلية، السويدية، والتركية. أي صوت من الأصوات الثمانية المتاحة يمكنه التحدث بأي من هذه اللغات دون قيود إضافية.
دعم لغات متعددة
يمكنك تحديد اللغة المطلوبة عبر حقل language في طلبك، أو الاعتماد على التخمين التلقائي الذي يفترض الإنجليزية للنصوص ذات الحروف اللاتينية ما لم تُحدد لغة أخرى. هذا يسهل عملية توليد القصص للأطفال بلغاتهم الأم دون حاجة لضبط معقد لكل لغة.
اللغات غير المدعومة تشمل الفيتنامية، الإندونيسية، التايلاندية، الأوكرانية، الرومانية، التشيكية، البنغالية وغيرها. إذا كانت اللغة المطلوبة ضمن القائمة أعلاه، فإن النظام جاهز للاستخدام الفوري.
- العربية، الصينية، الدنماركية، الهولندية
- الإنجليزية، الفنلندية، الفرنسية، الألمانية
- اليونانية، العبرية، الهندية، الإيطالية
- اليابانية، الكورية، الماليزية، النرويجية
- البولندية، البرتغالية، الروسية، الإسبانية
- السواحيلية، السويدية، التركية
الأصوات المتاحة
توفر الواجهة ثمانية أصوات بريميوم. تعتمد هذه الأصوات على تسجيلات مرخصة من مشروع LibriVox، مما يضمن جودة صوتية عالية وموثوقة للاستخدام التجاري أو الشخصي.
ثمانية أصوات بريميوم
تتوفر أربعة أصوات نسائية وأربعة أصوات رجالية، كل منها يتميز بنبرة فريدة تناسب نوع القصة. يمكنك اختيار "أريا" للسرد الواضح، أو "لونا" للحكايات، أو "أتلاس" للأخبار، و"أوريون" للوثائق. جميع الأصوات تدعم اللغات الـ23 المذكورة في المنصة.
- نسائية: أريا (ساردة)، نوفا (نشيط)، لونا (حكايات)، صاج (إرشادية)
- رجالية: فيليكس (ترويجي)، ميلو (حواري)، أتلاس (أخبار)، أوريون (وثائقي)
التسعير والدفع
يعتمد نموذج التسعير على الاستهلاك الفعلي، حيث تُحسب التكلفة بناءً على عدد الأحرف المرسلة في الطلبات الناجحة. السعر الثابت هو 10 دولارات أمريكية لكل مليون حرف، ما يعادل 0.01 دولار لكل 1000 حرف. تُحتسب المسافات علامات الترقيم كأحرف كاملة داخل النص المدخل.
الطلبات الفاشلة مجانية تماماً؛ إذا تعذّر توليف الصوت، يُسترد الرصيد بالكامل. لا توجد رسوم اشتراك شهرية أو حد أدنى للإنفاق أو رسوم صيانة. الرصيد المتبقي في حسابك لا ينتهي صلاحية، ويمكنك استخدام كامل الرصيد المتاح لتوليد الملفات المطلوبة.
نموذج الدفع حسب الاستخدام
طرق الدفع
نوفر لك طريقة دفع بسيطة ومباشرة تناسب المطورين المستقلين دون تعقيدات الفواتير أو الاشتراكات الشهرية. يمكنك شحن رصيدك بسهولة عبر عملة USDT على شبكة TRON، مما يضمن وصول الرصيد إلى حسابك تلقائياً خلال دقائق معددة من إتمام التحويل.
الدفع عبر USDT
نقبل حاليًا USDT على شبكة TRC-20 فقط، حيث يبلغ الحد الأدنى للإيداع 5 دولارات. لا توجد عمولات إضافية مخفية ولا حاجة لمعالجة بطاقات الائتمان أو PayPal، مما يبسط عملية الدفع لك ولأعمالك.
يتم إضافة الرصيد إلى حسابك تلقائيًا بمجرد تأكيد الشبكة، مما يتيح لك البدء في توليد القصص الصوتية فورًا دون انتظار الموافعات اليدوية.
- شبكة TRON (TRC-20) فقط
- الحد الأدنى للإيداع 5 دولارات
- إضافة تلقية وسريعة للرصيد
- لا اشتراكات أو فواتير شهرية
الميزات التقنية
تتم معالجة طلبات التوليد بالتتابع، مما يعني أن الطلبات الإضافية قد تنتظر في طابور عند ارتفاع الحمل. بالنسبة للنصوص الطويلة، يكون المعدل النموذجي قريبًا من الزمن الحقيقي، حيث يُنتج ما يقرب من 25 حرفًا من النص لكل ثانية من الصوت المُصنع. أما الجمل القصيرة فغالبًا ما تستغرق بضع ثوانٍ لإكمالها.
يبدأ الحد الأقصى لمعدلات الطلب عند 10 طلبات في الدقيقة لكل مفتاح. يُرفع هذا الحد تلقائيًا إلى 60 طلبًا في الدقيقة بمجرد إجراء أول شحن رصيد (Top-up)، مما يضمن استمرارية عمل تطبيقاتك دون انقطاع.
معدلات الطلب والحدود
تتم معالجة طلبات التوليد بالتتابع، مما يعني أن الطلبات الإضافية قد تنتظر في طابور عند ارتفاع الحمل. بالنسبة للنصوص الطويلة، يكون المعدل النموذجي قريبًا من الزمن الحقيقي، حيث يُنتج ما يقرب من 25 حرفًا من النص لكل ثانية من الصوت المُصنع. أما الجمل القصيرة فغالبًا ما تستغرق بضع ثوانٍ لإكمالها.
يبدأ الحد الأقصى لمعدلات الطلب عند 10 طلبات في الدقيقة لكل مفتاح. يُرفع هذا الحد تلقائيًا إلى 60 طلبًا في الدقيقة بمجرد إجراء أول شحن رصيد (Top-up)، مما يضمن استمرارية عمل تطبيقاتك دون انقطاع.
التجربة المجانية
عند التسجيل في حسابك عبر Google، تحصل فورًا على رصيد تجريبي بقيمة 0.50 دولار، مما يتيح لك اختبار جودة الصوت دون دفع مسبق. هذا الرصيد يعادل حوالي 50,000 حرف، وهو كافي لتجربة عدة جمل أو مقاطع قصيرة من قصص الأطفال.
تجربة مجانية صُممت لتمكّن المطور المستقل من فهم أداء الواجهة بسرعة. يمكنك استخدامها للتحقق من الأصوات واللغات قبل الالتزام بالدفع، دون الحاجة لإدخال بيانات بطاقة الائتمان.
رصيد تجريبي عند التسجيل
يُمنح الرصيد تلقائيًا عند إنشاء الحساب عبر تسجيل الدخول بحساب Google. أما إذا اخترت التسجيل باستخدام البريد الإلكتروني وكلمة المرور، فلن يتوفر لك هذا الرصيد المبدئي، وستحتاج إلى تعبئة رصيدك للبدء في استخدام الواجهة.
يظل الرصيد التجريبي ساري المفعول لمدة 7 أيام من تاريخ التسجيل.
- قيمة الرصيد: 0.50 دولار
- عدد الأحرف المشمولة: حوالي 50,000 حرف
- مدة الصلاحية: 7 أيام
- الشروط: متاح فقط مع تسجيل الدخول عبر Google

الأمان والمصادقة
تتطلب واجهة برمجة التطبيقات مصادقة آمنة لضمان استخدام رصيدك بشكل صحيح. يتم التحكم في الوصول عبر مفتاح API فريد يرتبط بحسابك، مما يضمن أن كل طلب صوتي يتم تحصيله من الحساب الصحيح.
إدارة مفاتيح API
تستخدم النظام مفتاح bearer واحد نشط لكل حساب. عند إنشاء مفتاح جديد، يصبح ساري المفعول فورًا ويتوقف المفتاح القديم عن العمل على الفور. هذا يعني أنه يمكنك تجديد الأمان دون حاجة لإعادة كتابة الكود في بيئات متعددة إذا فقدت المفتاح القديم.
- مفتاح واحد نشط لكل حساب
- إصدار مفتاح جديد يوقف القديم فورًا
- يتم إرساله في رأس Authorization: Bearer
الخصوصية والبيانات
عند إرسال النص عبر واجهة البرمجة، تُستخدم النصوص المدخلة حصريًا لإنتاج ملف الصوت المطلوب. لا يتم الاحتفاظ بالنص الأصلي بعد المعالجة، ولا يُستخدم في تدريب نماذج الذكاء الاصطناعي أو تحسينها، مما يضمن بقاء المحتوى الخاص بك ملكًا لك بالكامل.
تُحفظ بيانات الطلب الأساسية مثل الوقت وعدد الأحرف وحالة المعالجة فقط لأغراض الفواتير والتدقيق في الرصيد. ملفات الصوت المُولَّدة تُعاد في الاستجابة الفورية ولا يتم تخزينها على خوادمنا، مما يحد من تراكم البيانات غير الضرورية.
استخدام البيانات
يتم استخدام النص المدخل فقط لإنتاج الصوت المطلوب ولا يُستخدم للتدريب. البيانات الوصفية للطلب تُحفظ للفواتير فقط.
ملفات الصوت تُعاد في الاستجابة ولا تُخزن. الخصوصية مضمونة لعدم الاحتفاظ بالنصوص أو الملفات الصوتية بعد التسليم.
- النص يُستخدم للإنتاج فقط.
- لا يُستخدم للتدريب.
- بيانات الطلب تُحفظ للفواتير.
- الصوت لا يُخزن.
التكامل
تكامل واجهة برمجة التطبيقات الصوتية مع تطبيقاتك أمر بسيط ومباشر. يمكنك استخدام مكتبات OpenAI الرسمية بسهولة، حيث يتطلب الأمر فقط تغيير عنوان الخادم الأساسي (base_url) ليชี้ إلى https://api.qokl.info/v1، واستخدام مفتاح API الخاص بك. هذا يسمح لك باستدعاء نقطة النهاية /v1/audio/speech بنفس الطريقة التي تتعامل بها مع خدمات النصوص إلى كلام الأخرى.
استخدام مكتبات OpenAI
للاستفادة من مكتبات OpenAI، قم بتثبيت الحزمة المناسبة للغة البرمجة التي تستخدمها، ثم قم بتعيين متغير البيئة أو معلمة الاتصال الأساسي إلى https://api.qokl.info/v1. سيتم التعامل مع طلبات JSON بنفس الهيكل المعروف، مما يلغي الحاجة إلى كتابة منطق اتصال معقد من الصفر.
تأكد من إرسال النموذج المطلوب (tts-1 أو tts-1-hd)، والنص كحد أقصى 4096 حرفاً، واسم الصوت، وصيغة الصوت المطلوبة. ستحصل على ملف الصوت مباشرة في الاستجابة، مما يسهل دمج القصص الصوتية في تطبيقات الأطفال أو المنصات التعليمية.
- تغيير base_url فقط إلى https://api.qokl.info/v1
- استخدام نفس كائنات الطلب لواجهة OpenAI
- دعم كامل لمكتبات OpenAI الرسمية
الدعم الفني
نوفر دعمًا تقنيًا مباشرًا لمطوري التطبيقات المستقلين عبر البريد الإلكتروني فقط، لضمان معالجة استفساراتك التقنية بدقة وسرعة. لا نملك أرقام هواتف أو محادثات حية، مما يتيح لنا التركيز على حل مشكلات التكامل وإرشادك حول أفضل الممارسات في استخدام الواجهة البرمجية.
كيفية التواصل معنا
للتواصل معنا، يرجى إرسال بريد إلكتروني يحتوي على وصف المشكلة، وعنوان الـ API المستخدم، وأكواد الخطأ إن وجدت. نحرص على الرد في أسرع وقت ممكن لتقديم المساعدة التقنية اللازمة.
الأسئلة الشائعة
تساعد هذه الأسئلة في توضيح النقاط الأساسية حول استخدام واجهة برمجة التطبيقات الصوتية الخاصة بنا. نوضح هنا التفاصيل التقنية والمالية التي قد تثير فضول المطورين عند البدء في دمج الخدمة في تطبيقاتهم.
نركز على الإجابات المباشرة التي تغطي الجوانب العملية للنطاق، اللغات، الأصوات، وكيفية عمل التسعير.
أسئلة متكررة
هل تدعم الواجهة إصدارات صوتية مختلفة؟ نعم، توفر الواجهة نموذجين: tts-1 و tts-1-hd، وكلاهما يعمل بنفس المحرك وسعر نفس الوحدة.
ما هو الحد الأقصى للنص في كل طلب؟ يمكنك إرسال ما يصل إلى 4096 حرفًا في الطلب الواحد. للنصوص الأطول، قم بتقسيمها ودمج الملفات الصوتية الناتجة.
هل يمكنني استخدام مفتاح API مع مكتبات OpenAI؟ بالتأكيد. فقط قم بتغيير base_url إلى https://api.qokl.info/v1 واستخدم مفتاحك الخاص.
- الحد الأقصى للحروف: 4096 حرفًا لكل طلب.
- الصيغ المدعومة: mp3, wav, opus, flac, pcm.
- سرعة الصوت: تتراوح بين 0.25 و 4.0.
- اللغات المدعومة: 23 لغة بما فيها العربية والإنجليزية.
استمع إلى الأصوات الثمانية
تم إنشاء كل عينة أدناه باستخدام هذه الواجهة البرمجية من نفس الجملة. ميزة فريدة تتيح لك استخدام أي من هذه الأصوات الثمانية في أي من اللغات المدعومة، دون الحاجة لتثبيت نطق مخصص لكل صوت على حدة.
23 لغة
يمكن لأي صوت التحدث بأي من هذه اللغات.
