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

دليل إعداد AstrBot

اربط AstrBot مع Kitta Audio عبر OpenAI TTS Provider واستخدم صوتك المستنسخ في ردود الوكيل.

ربط Kitta Audio TTS مع AstrBot

يمكن لـ AstrBot استدعاء Kitta Audio من خلال نقطة صوت متوافقة مع OpenAI. تتم إدارة الشخصيات ومزودي TTS بشكل منفصل، لذلك أنشئ المزود أولاً ثم عيّنه من الإعداد الافتراضي أو قاعدة مخصصة.

تجهيز API Key وVoice ID

أنشئ مفتاحاً من صفحة إدارة API، وانسخ Voice ID للصوت المستنسخ، وتحقق من رصيد API. يمكن استخدام الصوت العام التالي في الاختبار الأول:

00a1b221-6137-4b73-ad62-b0cbce134167

إضافة مزود TTS

من لوحة AstrBot أضف مزود تحويل النص إلى كلام واختر OpenAI TTS (API).

الإعدادالقيمة
API Keyمفتاح Kitta Audio API
API Base URLhttps://fishaudio.org/v1
Modelfishaudio-s21pro-flash
VoiceVoice ID للصوت المستنسخ
Timeoutيوصى بـ 60 ثانية

يجب أن ينتهي Base URL عند /v1، وسيستدعي AstrBot المسار /v1/audio/speech تلقائياً.

لا تختر FishAudio TTS (API)

يستخدم هذا المزود واجهة أصلية مختلفة ويتطلب reference ID سداسياً من 32 محرفاً. لأصوات fishaudio.org استخدم OpenAI TTS Provider وVoice ID الخاص بالمنصة.

تفعيل الردود الصوتية

فعّل TTS في AstrBot واختر المزود الذي أنشأته. لعدة وكلاء، أنشئ مزوداً لكل Voice ID ثم اربط الشخصية ومزود TTS باستخدام القواعد المخصصة.

استكشاف الأخطاء

  • Voice غير صالح: أدخل Voice ID وليس اسم العرض.
  • 404: استخدم https://fishaudio.org/v1 من دون تكرار /audio/speech.
  • 401/402: تحقق من المفتاح ومن رصيد API المستقل.
  • واجهة خاطئة: اختر OpenAI TTS (API) وليس FishAudio TTS (API).
  • انتهاء المهلة: اضبط Timeout على 60 ثانية واختبر نصاً قصيراً أولاً.

مستندات مرتبطة