تم إطلاق واجهة برمجة التطبيقات العامة لـ Speechdash

واجهة برمجة التطبيقات العامة لـ Speechdash متاحة الآن على api.speechdash.com/v1. إذا كنت تقوم ببناء منتجات يحتاج فيها الأشخاص إلى الاستماع إلى النصوص، يمكنك إنشاء مستندات و توليد كلام دون فتح واجهة المستخدم للمتصفح.

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

ماذا تقدم واجهة برمجة التطبيقات اليوم

تعكس واجهة برمجة التطبيقات REST مكدس الاستماع الذي تعرفه بالفعل من التطبيق:

• إنشاء وإدارة المستندات في مكتبة Speechdash الخاصة بالمستخدم (استيراد النصوص مع العنوان واللغة)
• توليد كلام باستخدام إعدادات الصوت المسبقة Narrator وQuestioner وExpert بـ لغات كثيرة
• عرض وقراءة وتحديث وحذف المستندات من خلال نقاط نهاية JSON المتوقعة

المستندات التي تم إنشاؤها عبر واجهة برمجة التطبيقات تظهر في المكتبة على speechdash.com. يمكن لمستخدميك الاستمرار في الاستماع في التطبيق، وتعديل النصوص، وتصدير الصوت، أو الاستئناف من جهاز آخر.

يستخدم توليد الكلام الأصوات السحابية نفسها مثل تشغيل الصوت داخل التطبيق. يتم خصم الاستخدام من المحفظة الائتمانية للحساب، مع نفس القواعد مثل الاستماع السحابي في المنتج.

لمن هذه الواجهة؟

تصل الفرق إلى واجهة برمجة التطبيقات عندما يجب أن يعيش الاستماع داخل منتج آخر:

• منصات LMS ودورات الدراسة التي تريد قراءة aloud للمهام أو المقالات
• طبقات إمكانية الوصول داخل أدوات SaaS
• الأدوات الداخلية التي تستورد محتوى مجمّع للمراجعة عن طريق السمع
• النماذج الأولية التي تحتاج إلى معاينة منطوقة قبل شحن واجهة مستخدم كاملة

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

المصادقة والتوثيق

ينشئ كل حساب مفاتيح API تحت الإعدادات → API في التطبيق. تُعرض المفاتيح مرة واحدة؛ يتم تخزين بادئة فقط على الخادم.

أرسل Authorization: Bearer sh_live_… في كل طلب. تتلقى المفاتيح غير الصالحة أو الملغاة استجابة 401.

توجد وثائق المطور في مركز المساعدة:

• نظرة عامة على API (المصادقة، الحدود، الفوترة، عدم التكرار)
• عقد OpenAPI الحي على api.speechdash.com/v1/openapi.json

صفحة ميزة التسويق واجهة برمجة التطبيقات العامة تلخص القصة للمطورين غير التقنيين في فريقك.

الفوترة نظرة عامة

طلبات الكلام تحجز تقدير، ثم تستقر على المدة المقاسة. يمكن للمحاولات إعادة إرسال Idempotency-Key عند إنشاء المستند والكلام حتى لا تضاعف الشبكة الفوترة.

تنطبق حدود المعدل لكل حساب (وليس لكل مفتاح). تتضمن الاستجابات رؤوس حدود المعدل القياسية وRetry-After عند الحاجة إلى التباطؤ.

أول طلب في خمس دقائق

1. سجل الدخول على speechdash.com وافتح الإعدادات → API
2. أنشئ مفتاحًا وانسخه فورًا
3. اقرأ نظرة عامة على API
4. POST نص قصير إلى /v1/documents أو استدعِ /v1/audio/speech مع إعداد صوت مسبق ولغة

ابدأ بعينة من جملتين قبل أن تقوم بتشغيل فصل كامل. توضح وثيقة النظرة العامة الحقول الدقيقة والاستجابات النموذجية.

ماذا سيأتي بعد ذلك

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

شكرًا لك على البناء مع Speechdash. نحن متحمسون لسماع ما ستقوم بإنشائه.

الأدلة ذات الصلة

• صفحة ميزة واجهة برمجة التطبيقات العامة
• بدء استخدام Speechdash
• التشغيل السحابي
• تنسيقات الاستيراد
• ما الذي يستخدم الائتمان