الأسئلة الشائعة
ما هي واجهة برمجة التطبيقات هذه؟
هي خدمة سحابية بسيطة لتحويل النصوص إلى ملفات صوتية عبر طلب HTTP. ترسل النص وتستمع إلى النتيجة بصيغة JSON متوافقة مع OpenAI. تدعم الطلبات حتى 4096 حرفاً، مع إمكانية تعديل السرعة واللغة، مما يجعلها مثالية لأتمتة الإشعارات الصوتية في أنظمة المنزل الذكي.
ما هي اللغات المدعومة؟
ندعم 23 لغة، بما في ذلك العربية، الإنجليزية، الصينية، الفرنسية، الألمانية، الإسبانية، الروسية، والهندية. يمكنك تحديد لغة النص عبر كود ISO، أو نترك النظام يكتشفها تلقائياً. اللغات غير المدعومة تشمل الفيتنامية، التايلاندية، الأوكرانية، الرومانية، التشيكية، والبنغالية وغيرها.
كم عدد الأصوات المتاحة؟
نوفر 8 أصوات افتراضية متنوعة بين الذكور والإناث. تشمل الأناث: Aria وNova وLuna وSage. ويشمل الذكور: Felix وMilo وAtlas وOrion. كل صوت يتميز بنبرة محددة، من السرد الواضح إلى الأخبار المحايدة، ويمكنه نطق جميع اللغات المدعومة بدقة.
ما هو سعر الاستخدام؟
السعر هو 10 دولارات أمريكية لكل مليون حرف، أي 0.01 دولار لكل 1000 حرف. المسافات وعلامات الترقيم تُحسب ضمن الأحرف. الطلبات الفاشلة مجانية تماماً، حيث يتم استرداد المبلغ بالكامل. لا توجد رسوم اشتراك شهرية أو حد أدنى للإنفاق.
كيف يمكنني الدفع؟
الدفع يتم حصرياً عبر عملة USDT على شبكة TRON (TRC-20). الحد الأدنى للإيداع هو 5 دولارات، ويتم تحديث رصيدك تلقائياً خلال دقائق. لا نقبل البطاقات أو PayPal أو الفواتير الضريبية. الرصيد لا ينتهي، ويمكنك إصدار مفتاح API جديد في أي وقت من لوحة التحكم.
هل هناك تجربة مجانية؟
نعم، عند التسجيل عبر حساب Google، تحصل على رصيد تجريبي بقيمة 0.50 دولار، مما يكفي لنحو 50,000 حرفاً، ويكون ساري المفعول لمدة 7 أيام. إذا سجلت بالبريد الإلكتروني وكلمة المرور، لا تحصل على رصيد تجريبي. الرصيد يظل صالحاً طالما لديك رصيد.
ما هي صيغ الصوت المدعومة؟
يمكنك اختيار صيغ الصوت من بين MP3، WAV، Opus، FLAC، وPCM. هذه الصيغ تناسب مختلف احتياجات التكامل مع أجهزة إنترنت الأشياء. يتم إرسال ملف الصوت مباشرة في استجابة الطلب، دون الحاجة إلى تخزين مؤقت أو معالجة إضافية من جانبك.
هل يتم تخزين النصوص؟
لا، النص المدخل يُستخدم فقط لتوليد ملف الصوت ولا يُستخدم لتدريب النماذج. ملف الصوت يُعاد إليك في الاستجابة ولا يتم تخزينه. نحتفظ فقط ببيانات الطلب (الوقت، عدد الأحرف، الحالة) لأغراض الفوترة وإدارة الحساب، دون الاحتفاظ بمحتوى النص الأصلي.
الطلب الأول
curl
curl https://api.rsm3.info/v1/audio/speech \
-H "Authorization: Bearer $TTS_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"tts-1","voice":"aria","input":"Hello from the API.","response_format":"mp3"}' \
--output hello.mp3Python (openai)
from openai import OpenAI
client = OpenAI(base_url="https://api.rsm3.info/v1", api_key="tts-...")
with client.audio.speech.with_streaming_response.create(
model="tts-1", voice="nova", input="Hello from Python.", response_format="mp3"
) as response:
response.stream_to_file("hello.mp3")Node.js (openai)
import OpenAI from "openai";
import fs from "node:fs";
const client = new OpenAI({ baseURL: "https://api.rsm3.info/v1", apiKey: process.env.TTS_API_KEY });
const res = await client.audio.speech.create({ model: "tts-1", voice: "milo", input: "Hello from Node.js." });
fs.writeFileSync("hello.mp3", Buffer.from(await res.arrayBuffer()));| voice | |
|---|---|
aria | أنثى |
nova | أنثى |
luna | أنثى |
sage | أنثى |
felix | ذكر |
milo | ذكر |
atlas | ذكر |
orion | ذكر |
| language | |
|---|---|
ar | العربية |
zh | 中文 |
da | Dansk |
nl | Nederlands |
en | English |
fi | Suomi |
fr | Français |
de | Deutsch |
el | Ελληνικά |
he | עברית |
hi | हिन्दी |
it | Italiano |
ja | 日本語 |
ko | 한국어 |
ms | Bahasa Melayu |
no | Norsk |
pl | Polski |
pt | Português |
ru | Русский |
es | Español |
sw | Kiswahili |
sv | Svenska |
tr | Türkçe |
ما هي واجهة برمجة التطبيقات؟
واجهة SautHome هي خدمة سحابية بسيطة لتحويل النص إلى كلام، مصممة خصيصاً لمطوري المنازل الذكية وأجهزة إنترنت الأشياء. ما عليك سوى إرسال نص عبر POST واستقبال ملف صوتي جاهز للاستخدام في تطبيقاتك.
كيف تعمل واجهة برمجة التطبيقات السحابية
تعمل الواجهة عبر إرسال طلب JSON يحتوي على النص والصوت المطلوب إلى نقطة النهاية POST https://api.rsm3.info/v1/audio/speech. ستستلم رداً فورياً يحتوي على ملف الصوت بالصيغة المختارة، مما يسهل دمج الرسائل الصوتية في أنظمة المنزل الذكي دون تعقيدات.
مطابقة شكل الطلب مع واجهة OpenAI
نستخدم نفس هيكل الطلب المستخدم في واجهة OpenAI الصوتية، مما يعني أنك لا تحتاج لتعلم بروتوكول جديد. فقط حدد النموذج (tts-1 أو tts-1-hd)، النص المدخل، الصوت المفضل، والصيغة المطلوبة.
سهولة التكامل مع SDKs الرسمية
بفضل تطابق الهيكل، يمكنك استخدام مكتبات OpenAI الرسمية بسهولة. فقط قم بتغيير base_url إلى https://api.rsm3.info/v1 واستخدم مفتاح API الخاص بك كما تفعل عادة، مما يوفر وقت التطوير.
نقاط النهاية المتاحة للطلبات
الوظيفة الأساسية هي POST /v1/audio/speech لتوليد الصوت. كما توفر GET /v1/voices للتحقق من الأصوات واللغات المدعومة، وGET /v1/models لعرض النماذج المتاحة حالياً.
الأصوات واللغات المدعومة
تدعم واجهة SautHome توليد الصوت بـ 23 لغة عالمية، مما يجعلها أداة مرنة لمطوري المنازل الذكية الذين يتعاملون مع جمهور متنوع. سواء كنت تبسط تعليمات جهاز ذكي بالإنجليزية أو تضيف نطقاً باللغة العربية، فإن لغتك مدعومة بالكامل دون حاجة إلى إضافات خارجية.
قائمة اللغات الـ 23 المدعومة بالكامل
اللغات المدعومة تشمل: العربية، الصينية، الدنماركية، الهولندية، الإنجليزية، الفنلندية، الفرنسية، الألمانية، اليونانية، العبرية، الهندية، الإيطالية، اليابانية، الكورية، الملايوية، النرويجية، البولندية، البرتغالية، الروسية، الإسبانية، السواحيلية، السويدية، والتركية.
توليف اللغة تلقائياً أو يدوياً
يمكنك تحديد لغة النص عبر حقل language باستخدام رمز ISO، وهو ضروري للنصوص غير الإنجليزية المكتوبة بالأبجدية اللاتينية. إذا لم تُحدد اللغة، يحاول النظام تخمينها من النص، مع افتراض الإنجليزية كإعداد افتراضي للنصوص اللاتينية.
الأصوات الثمانية المتاحة (أنثى ورجل)
تتوفر ثمانية أصوات مخصصة لتلبية احتياجات مختلفة في واجهات المنزل الذكي، من التوجيه الهادئ إلى الإعلانات النشطة. جميع الأصوات تدعم اللغات الـ 23 المذكورة أعلاه.
- Aria: أنثى، راوية دافئة وواضحة.
- Nova: أنثى، مشرقة ومتفائلة.
- Luna: أنثى، ناعمة ومناسبة للقصص.
- Sage: أنثى، هادئة وتعليمية.
- Felix: ذكر، حيوي ومناسب للإعلانات.
- Milo: ذكر، ودود وحواري.
- Atlas: ذكر، محايد للأخبار.
- Orion: ذكر، عميق وثقافي.
خصائص الأصوات الثمانية
تم بناء الأصوات من تسجيلات مرخصة (LibriTTS-R) وقراءات من المكتبات العامة، مما يضمن جودة صوتية عالية وطبيعية. كل صوت مصمم لنمط معين، مثل الصوت الهادئ لـ Sage الذي يناسب تعليمات الأجهزة الهادئة، أو صوت Felix النشط للإعلانات.
دعم النصوص غير اللاتينية
يدعم النظام النصوص غير اللاتينية مثل العربية والصينية واليابانية والكورية بشكل كامل. عند استخدام هذه اللغات، تأكد من تحديد حقل اللغة لضمان النطق الصحيح.
الأسعار والدفع
واجهة SautHome مصممة للمطورين الذين يفضلون البساطة، حيث ندفع فقط مقابل ما نستهلكه من أحرف نصية دون تعقيدات الاشتراكات الشهرية. هذا النموذج يضمن شفافية كاملة في التكاليف، مما يتيح لك دمج التوليد الصوتي في مشاريعك دون مفاجآت في الفواتير.
نوفر تجربة مجانية فورية عند التسجيل عبر Google، مما يسمح لك باختبار الجودة قبل الالتزام. علاوة على ذلك، رصيدك لا ينتهي بمرور الوقت، مما يمنحك المرونة لإدارة مشاريع إنترنت الأشياء حسب وتيرتك الخاصة.
هيكل التسعير الشفاف
يبلغ السعر 10 دولارات أمريكية لكل مليون حرف، بما في ذلك المسافات وعلامات الترقيم. هذا يعني أن كل 1000 حرف تكلف 0.01 دولار فقط، وهو سعر ثابت ينطبق على جميع النصوص بغض النظر عن طولها.
طرق الدفع عبر USDT-TRC20
نقبل الدفع عبر عملة USDT على شبكة TRON (TRC-20) فقط، دون اشتراكات أو بطاقات ائتمان. الحد الأدنى للإيداع هو 5 دولارات، ويتم إضافة الرصيد تلقائياً إلى حسابك خلال دقائق معددة من إتمام التحويل.
تجربة مجانية لمدة 7 أيام
عند التسجيل عبر حساب Google، تحصل على رصيد تجريبي بقيمة 0.50 دولار، مما يكفي لتوليد حوالي 50,000 حرف. هذه التجربة سارية لمدة 7 أيام، بينما يبدأ حساب البريد الإلكتروني بالرصيد الفارغ.
سياسة استرداد المبالغ للفشل
إذا فشل طلب توليف الصوت بالكامل، يتم استرداد المبلغ كاملاً. لن يتم خصم أي مبلغ عن الطلبات التي لم تكتمل بنجاح، مما يضمن دفعك فقط مقابل النتائج الناجحة.
عدم انتهاء رصيد الحساب
رصيدك في حسابك لا ينتهي بمرور الوقت، مما يعني أنه يمكنك تخزين الرصيد واستخدامه متى احتجت إليه. لا توجد رسوم صيانة أو اشتراكات شهرية تنقص رصيدك، مما يجعله حلاً مثالياً للمشاريع طويلة الأمد.
الميزات التقنية
توفر واجهة SautHome مرونة كاملة في اختيار صيغ الملفات الصوتية لتتناسب مع بنيتك التحتية، مع دعم MP3 و WAV و OPUS و FLAC و PCM.
يمكنك التحكم الدقيق في سرعة النطق بين 0.25 و 4.0، مما يتيح تسريع النصوص الطويلة أو إبطائها للوضوح، مع معالجة تلقية للنصوص التي تتجاوز 4096 حرفاً.
صيغ الصوت المدعومة (MP3, WAV, OPUS, FLAC, PCM)
نوفر خمس صيغ صوتية لتغطية مختلف احتياجات التطبيقات، من ضغط الحجم (OPUS) إلى الجودة العالية (FLAC) والتوافق العام (MP3, WAV, PCM).
التحكم في سرعة النطق
تتيح لك المعلمة speed ضبط السرعة من 0.25 إلى 4.0 مرة من السرعة الطبيعية، لتناسب إيقيق الأجهزة الذكية أو شاشات العرض.
معالجة النصوص الطويلة تلقائياً
الحد المسموح به هو 4096 حرفاً في كل طلب، بما في ذلك المسافات وعلامات الترقيم. بالنسبة للنصوص الأطول، يمكنك تقسيمها وإدخالها كجزء من النص.
العلامة المائية الصوتية
يتم إضافة علامة مائية غير مرئية تلقائياً لكل ملف صوتي لتأكيد كونه كلاماً مولداً بواسطة الذكاء الاصطناعي.
سرعة التوليد المتوقعة
تعمل الطلبات بنظام الدور (queue)، حيث تستغرق النصوص القصيرة بضع ثوانٍ، بينما تتطابق سرعة النصوص الطويلة تقريباً مع الزمن الحقيقي.
الأمان والخصوصية
تضمن واجهة SautHome أن نصك المدخل يُستخدم حصرياً لإنتاج الملف الصوتي المطلوب، دون أي استخدام ثانوي للبيانات. لا يتم الاحتفاظ بالنصوص الخام بعد اكتمال التوليف، مما يضمن خصوصية جملك أو أوامر المنزل الذكي فوراً.
يتم تخزين بيانات الطلب الأساسية (الوقت، عدد الأحرف، والحالة) فقط لأغراض الفوترة والتأكد من دقة الحسابات. لا نحتفظ بالنص الذي أدخلته، ولا نستخدمه في تدريب النماذج، ولا نخزن الملفات الصوتية الناتجة بعد إرسالها لك.
استخدام النص فقط للتوليد
يتم معالجة النص المدخل مباشرة لتوليف الصوت وإعادته في الاستجابة. لا نستخدم نصوصك في تحسين الخوارزميات أو تدريب النماذج المستقبلية.
عدم استخدام البيانات للتدريب
نصوصك مخصصة فقط لإنشاء ملف الصوت الذي طلبته. نحن لا نستخدمها لبناء مجموعات بيانات أو تحسين نماذجنا بشكل مستقل.
عدم تخزين الملفات الصوتية
الملفات الصوتية تُعاد إليك عبر الاستجابة ولا يتم تخزينها على خوادمنا بعد إرسالها. هذا يعني أن بياناتك الصوتية مؤقتة ولا تبقى محفوظة.
إدارة مفاتيح API النشطة
يحتوي كل حساب على مفتاح واحد نشط في الوقت الحالي. يمكنك إصدار مفتاح جديد في أي وقت، مما يوقف المفتاح القديم فوراً.
حماية البيانات والخصوصية
نحتفظ بسجل الطلبات (الوقت، الأحرف، الحالة) فقط لحساب التكاليف بدقة.

التكامل والبرمجة
تتكامل واجهة SautHome بسلاسة مع بيئات المنزل الذكي وأجهزة إنترنت الأشياء (IoT) عبر بروتوكولات قياسية، مما يتيح للأجهزة الناطقة أو أنظمة التحكم الصوتي استقبال الملفات الصوتية مباشرة دون تعقيدات. يعتمد التكامل على إرسال طلبات بسيطة واستقبال ملفات صوتية جاهزة للاستخدام في الواجهات الصوتية للأجهزة.
تضمن البنية الموحدة توافقًا تامًا مع مكتبات HTTP الشائعة، مما يسهل على المطورين استخدام أي لغة برمجة تدعم الاتصال الشبكي. يمكن دمج API في أنظمة التشغيل الآلي للمنزل الذكي لتحويل النصوص إلى تنبيهات صوتية أو رسائل توجيهية للأجهزة المتصلة.
معدل الطلبات المسموح به
يُسمح بـ 60 طلبًا في الدقيقة لكل مفتاح API، مع حد أولي قدره 10 طلبات في الدقيقة قبل أول إيداع. يتم معالجة الطلبات بالتتابع، لذا قد ينتظر الطلب في الطابور تحت الضغط.
يضمن هذا المعدل استقرار الخدمة للأجهزة التي تحتاج إلى استجابات صوتية سريعة دون إرهاق الخادم. يمكن رفع الحد بعد شحن الرصيد.
- 60 طلبًا في الدقيقة بعد التفعيل الكامل
- 10 طلبات في الدقيقة قبل الشحن الأول
إصدار مفتاح API جديد
يمكنك إصدار مفتاح API جديد في أي وقت من لوحة التحكم. عند إصدار مفتاح جديد، يتوقف المفتاح القديم فورًا عن العمل.
يضمن هذا الإجراء الأمان العالي، حيث يمكنك تجديد المفتاح عند الشك في تسربه دون الحاجة إلى إعادة تسجيل الحساب.
- إصدار مفتاح جديد يدويًا
- إيقاف المفتاح القديم فورًا
استخدام مكتبات HTTP القياسية
بفضل توافق شكل الطلب مع واجهة OpenAI، يمكنك استخدام أي مكتبة HTTP قياسية لإرسال الطلبات. لا حاجة لمكتبات خاصة أو SDK مخصص.
يسهل هذا التوافق دمج الخدمة في أجهزة إنترنت الأشياء التي تدعم إرسال طلبات HTTP/HTTPS بسهولة.
نموذج الطلب JSON
يتم إرسال الطلب ككائن JSON يحتوي على حقول model, input, voice, response_format, و speed. مثال: `curl -X POST https://api.rsm3.info/v1/audio/speech -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" -d '{"model": "tts-1", "input": "مرحبا", "voice": "sage", "response_format": "mp3"}'`.
تستقبل ملف الصوت مباشرة في استجابة الطلب، مما يسهل حفظه أو بثه للأجهزة.
- نموذج طلب JSON قياسي
- استقبال ملف الصوت مباشرة
معالجة الأخطاء والاستجابة
في حال فشل الطلب، لا تُخصم المبلغ، ويتم إرجاع الرصيد تلقائيًا. تتكون استجابة الخطأ من كود HTTP ورسالة توضيحية.
تساعدك رسائل الخطأ الواضحة في تصحيح الأخطاء بسرعة، مثل تنسيق JSON غير الصحيح أو عدم وجود رصيد كافٍ.
- إرجاع الرصيد عند الفشل
- رسائل خطأ واضحة
الأسئلة الشائعة
أسئلة شائعة حول واجهة SautHome لتحويل النص إلى كلام. نقدم إجابات مباشرة ومحددة حول الميزات التقنية، التكلفة، وآلية العمل لضمان تجربة سلسة لمطوري إنترنت الأشياء.
نغطي هنا الجوانب الأساسية التي تساعدك على البدء بسرعة، من اختيار الصوت المناسب إلى فهم سياسة الخصوصية ودفع الاستخدام.
ما هي واجهة برمجة التطبيقات هذه؟
هي خدمة سحابية بسيطة لتوليد ملفات صوتية من النصوص. تعمل بنفس شكل طلبات OpenAI، مما يسهل التكامل باستخدام SDKs الرسمية أو طلبات HTTP المباشرة.
ما هي اللغات المدعومة؟
ندعم 23 لغة، بما في ذلك العربية، الإنجليزية، الصينية، والفرنسية. إذا لم تحدد اللغة، سيتم تخمينها تلقائياً بناءً على النص المدخل.
- العربية، الصينية، الدنماركية، الهولندية، الإنجليزية، الفنلندية، الفرنسية، الألمانية، اليونانية، العبرية، الهندية، الإيطالية، اليابانية، الكورية، الماليزية، النرويجية، البولندية، البرتغالية، الروسية، الإسبانية، السواحيلية، السويدية، التركية.
كم عدد الأصوات المتاحة؟
نوفر 8 أصوات افتراضية متنوعة (4 نسائية و4 ذكور)، مثل Aria وNova وFelix وAtlas، لتتناسب مع مختلف سيناريوهات المنازل الذكية.
ما هو سعر الاستخدام؟
التسعير شفاف وواضح: 10 دولارات لكل مليون حرف. يتم احتساب المسافات والعلامات كحروف. الطلبات الفاشلة مجانية ولا تُخصم.
كيف يمكنني الدفع؟
نقبل الدفع عبر USDT على شبكة TRON (TRC-20). الحد الأدنى للإيداع هو 5 دولارات، ويتم تفعيل الرصيد تلقائياً خلال دقائق.
هل هناك تجربة مجانية؟
نعم، تحصل على رصيد تجريب بقيمة 0.50 دولار (حوالي 50,000 حرف) لمدة 7 أيام عند التسجيل عبر Google.
ما هي صيغ الصوت المدعومة؟
يمكنك اختيار صيغ متعددة لتناسب جهازك أو تطبيقك: MP3، WAV، OPUS، FLAC، وPCM.
هل يتم تخزين النصوص؟
لا. النص المدخل يُستخدم فقط لتوليد الصوت ولا يُستخدم للتدريب. الملفات الصوتية تُرد في الاستجابة ولا يتم تخزينها.
ابدأ الآن
ابدأ رحلتك مع SautHome بإنشاء حسابك عبر الصفحة المخصصة، حيث يمكنك التسجيل بسهولة باستخدام حساب Google أو البريد الإلكتروني. بعد التسجيل، احصل على مفتاح API الفريد الخاص بك فوراً لبدء التكامل مع واجهات منزلك الذكية.
لإضافة الرصيد، استخدم شبكة TRON (USDT TRC-20) بحد أدنى 5 دولارات. يتم تحديث رصيدك تلقائياً خلال دقائق، مما يتيح لك البدء في تحويل النصوص إلى رسائل صوتية دون انتظار.
إنشاء حساب جديد
قم بالتسجيل عبر رابط /get-api-key/ باستخدام حساب Google أو بريدك الإلكتروني. الحساب خاص بالموقع ويوفر وصولاً فورياً للوحة التحكم.
الحصول على مفتاح API
ستظهر مفتاحك مباشرة في لوحة التحكم. يمكنك إصدار مفتاح جديد في أي وقت، حيث سيتوقف المفتاح القديم فوراً.
إضافة رصيد للحساب
أرسل USDT عبر شبكة TRC-20 (حد أدنى 5$). يتم تحديث الرصيد تلقائياً خلال دقائق. الرصيد لا ينتهي.
- شبكة TRON (TRC-20) فقط
- حد أدنى للإضافة: 5 دولار
- تحديث تلقائي خلال دقائق
اختبار أول طلب
جرب التجربة المجانية (0.50$) إذا سجلت عبر Google. استخدم نموذج curl المرفق لإرسال النص واستقبال ملف الصوت عبر POST.
مراجعة الاستخدام والفواتير
راقب استهلاكك والأرصدة المتبقية مباشرة من لوحة التحكم. كل طلب ناجح يحسب حروفه بدقة (مسافات وعلامات ترقيم).
استمع إلى الأصوات الثمانية
تم إنشاء كل عينة أدناه باستخدام هذه الواجهة البرمجية من نفس الجملة. تساعد الأسئلة الشائعة في توضيح النقاط التقنية والعملية للواجهة.
23 لغة
يمكن لأي صوت التحدث بأي من هذه اللغات.
المصادر ومزيد من القراءة
- Wikipedia
- LibriTTS-R corpus (OpenSLR 141)
- LibriTTS-R paper (arXiv 2305.18802)
- Creative Commons Attribution 4.0
- MDN: Web Speech API
- LibriVox public-domain audiobooks
- ISO 639 language codes
- openai-node on GitHub
- Node.js documentation
- curl documentation
- TRON developer hub: TRC-20
- OpenAI API reference: create speech
