Kitta Audio Docs
أدلة التكاملتكاملات الطرف الثالث
Back to site

إعداد مساعد المنزل

استخدم نقطة النهاية المخصصة HACS OpenAI TTS لإنشاء إعلانات Kitta Audio واستجابات المساعد الصوتي في Home Assistant.

قم بتوصيل Kitta Audio TTS بالمساعد المنزلي

يستخدم هذا الدليل تكامل HACS OpenAI TTS الذي يدعم نقاط النهاية المخصصة المتوافقة مع OpenAI. يرسل خطاب Kitta Audio إلى مشغلات الوسائط Home Assistant للإعلانات والأتمتة والمساعدة.

Choose the correct integration

لا يوفر تكامل المحادثة OpenAI المدمج عنوان URL الأساسي TTS لجهة خارجية. هذا يستخدم الدليل تكامل sfortis/openai_tts HACS بدلاً من ذلك.

تثبيت التكامل

  1. افتح HACS وابحث عن عمليات التكامل عن OpenAI TTS.
  2. قم بتنزيله وإعادة تشغيل Home Assistant.
  3. افتح Settings → Devices & Services → Add Integration → OpenAI TTS.
  4. أدخل مفتاح Kitta Audio API ونقطة النهاية المخصصة https://fishaudio.org/v1.

أضف وكيل TTS باستخدام:

الإعدادالقيمة
نموذجfishaudio-s21pro-flash
صوت00a1b221-6137-4b73-ad62-b0cbce134167
تنسيق الصوتmp3
السرعة1

يقبل وضع نقطة النهاية المخصصة معرف الصوت Kitta Audio الذي تم إدخاله يدويًا. استبدل صوت الاختبار بعد أول إعلان ناجح.

اختبار إعلان

استدعاء إجراء openai_tts.say الخاص بالتكامل من أدوات المطور:

action: openai_tts.say
target:
  entity_id: media_player.living_room_speaker
data:
  tts_entity: tts.openai_tts_fish_audio
  message: 'Hello, this is a Kitta Audio smart-home announcement.'
  volume: 0.6

استبدل معرفي الكيانين بوكيل TTS الفعلي ومشغل الوسائط. بعد أن يعمل، أعد استخدام الإجراء في أتمتة جرس الباب أو التنبيه أو الطقس أو التقويم.

استكشاف الأخطاء وإصلاحها

  • لا يوجد حقل نقطة نهاية مخصص: تأكد من تثبيت تكامل HACS OpenAI TTS، وليس محادثة OpenAI المضمنة.
  • مكبر الصوت صامت: تأكد من أن media_player يمكنه تشغيل الوسائط العادية وفحص سجلات Home Assistant.
  • أصوات Kitta Audio غير مدرجة: أدخل المعرف الصوتي يدويًا في وضع نقطة النهاية المخصصة.
  • 401/402: تحقق من مفتاح API ورصيد API الائتماني.

الوثائق ذات الصلة