دليل إعداد API المتوافق مع OpenAI
نظرة عامة
يدعم Sokuji أي نقطة نهاية متوافقة مع Realtime API من OpenAI، مما يتيح لك استخدام خدمات الطرف الثالث أو الخدمات المستضافة ذاتيًا للترجمة الصوتية في الوقت الفعلي. يمنحك هذا المرونة لاختيار مزودين بديلين أو تشغيل خادم الاستدلال الخاص بك.
مهم: يتطلب التوافق مع Realtime API
يجب أن يدعم المزود بروتوكول WebSocket الخاص بـ Realtime API من OpenAI، وليس فقط API Chat Completions القياسي. فقط نقاط النهاية التي تنفذ Realtime API ستعمل مع Sokuji.
1اختر مزودًا متوافقًا
اختر خدمة تدعم بروتوكول WebSocket الخاص بـ Realtime API من OpenAI. مهم: عدد قليل جدًا من المزودين يدعمون حاليًا Realtime API — معظم الخدمات المتوافقة مع OpenAI تدعم فقط API Chat Completions، وهو غير كافٍ. تحقق دائمًا من أن مزودك يدعم صراحةً Realtime API قبل المتابعة.
2احصل على نقطة نهاية API والمفتاح
احصل على URL نقطة نهاية API ومفتاح API من المزود الذي اخترته. عادةً ما تكون URL نقطة النهاية بتنسيق https://your-provider.com أو http://localhost:8080 للخدمات المستضافة ذاتيًا.
3حدد API المتوافق مع OpenAI في Sokuji
افتح Sokuji وانتقل إلى لوحة الإعدادات. حدد "OpenAI Compatible API" كمزود الذكاء الاصطناعي من القائمة المنسدلة للمزودين.
4أدخل التكوين الخاص بك
الصق URL نقطة نهاية API المخصصة في حقل "API Endpoint". أدخل مفتاح API في حقل "API Key". إذا كان مزودك لا يتطلب مفتاح API (مثل الخدمات المحلية)، يمكنك تركه فارغًا أو إدخال قيمة بديلة.
5حدد النموذج والصوت
اختر إعدادات النموذج والصوت التي يدعمها مزودك. تعتمد الخيارات المتاحة على مزودك المحدد. تشمل النماذج الشائعة gpt-4o-realtime-preview أو أسماء نماذج خاصة بالمزود.
6اختبر الاتصال
ابدأ جلسة ترجمة للتحقق من أن كل شيء يعمل. انقر على زر بدء الجلسة، وتحدث في الميكروفون، وتحقق من أن الاتصال يتم بنجاح وأن الصوت يتم ترجمته.
معلومات إضافية
ما هو API المتوافق مع OpenAI؟
API المتوافق مع OpenAI هو خيار مزود عام يسمح لـ Sokuji بالاتصال بأي خدمة تنفذ بروتوكول Realtime API من OpenAI:
- استخدم أي نقطة نهاية متوافقة مع OpenAI مع URL أساسي مخصص
- يدعم الخدمات المستضافة سحابيًا والمستضافة ذاتيًا
- مرونة التبديل بين مزودي الخلفية المختلفين
- مفيد للنشر الخاص، أو تحسين التكاليف، أو الامتثال الإقليمي
حول توافق المزود
معظم الخدمات المتوافقة مع OpenAI تدعم فقط API Chat Completions. Realtime API (القائم على WebSocket، مع بث الصوت) هو بروتوكول مختلف وعدد قليل جدًا من المزودين يدعمونه:
- Azure OpenAI Service: يدعم Realtime API مع نماذج OpenAI المستضافة على Microsoft Azure
- تحقق دائمًا من وثائق مزودك للحصول على دعم صريح لـ Realtime API
- خدمات مثل OpenRouter و Together AI وما إلى ذلك عادةً لا تدعم Realtime API
- بعض خدمات الوكيل (مثل CometAPI) قد توفر توافقًا مع Realtime API — تحقق قبل الاستخدام
- الحلول المستضافة ذاتيًا يجب أن تنفذ بروتوكول WebSocket الكامل لـ Realtime API
نصائح التكوين
- يجب ألا تتضمن URL نقطة النهاية شرطة مائلة لاحقة (مثلاً، استخدم https://api.example.com وليس https://api.example.com/)
- للخدمات المحلية، استخدم http://localhost:<port> كنقطة نهاية
- قد يتطلب بعض المزودين رؤوسًا محددة أو طرق مصادقة
- إذا كنت تستخدم خدمة وكيل، تأكد من أنها تعيد توجيه اتصالات WebSocket بشكل صحيح
استكشاف الأخطاء وإصلاحها
المشاكل الشائعة
رفض الاتصال: تحقق من أن URL نقطة النهاية صحيح وأن الخدمة تعمل. للخدمات المحلية، تأكد من أن الخادم قد بدأ ويستمع على المنفذ المتوقع.
خطأ في المصادقة: تحقق مرة أخرى من مفتاح API. بعض المزودين يتطلبون تنسيقات مفاتيح محددة. تأكد من أن حسابك لديه حق الوصول إلى Realtime API.
النموذج غير موجود: قد يختلف اسم النموذج عن نماذج OpenAI الافتراضية. راجع وثائق مزودك لمعرفة أسماء النماذج المتاحة.
فشل اتصال WebSocket: تأكد من أن مزودك يدعم اتصالات WebSocket لـ Realtime API. نقاط النهاية القياسية HTTP فقط (Chat Completions) لن تعمل.
التحقق من توافق المزود
- تحقق من أن مزودك يدعم صراحةً بروتوكول Realtime API من OpenAI
- تأكد من دعم اتصالات WebSocket (وليس REST API فقط)
- تأكد من أن المزود يدعم بث الصوت للإدخال/الإخراج
- اختبر URL نقطة النهاية مباشرة باستخدام عميل WebSocket إن أمكن
- راجع وثائق المزود لأي متطلبات تكوين محددة
هل تحتاج إلى مزيد من المساعدة؟ راجع وثائق Realtime API من OpenAI لتفاصيل البروتوكول، أو قم بزيارة مستودع GitHub الخاص بنا للحصول على دعم المجتمع.