دليل إعداد RikkaHub
وجّه موفر Kitta AI في RikkaHub إلى نقطة النهاية المتوافقة /v1/tts ثم عيّن معرّف الصوت والنموذج.
ربط Kitta AI TTS مع RikkaHub
في RikkaHub، اختر موفر صوت Kitta AI ووجّه قاعدة API إلى Kitta AI بدلًا من api.fish.audio. ثم اضبط مفتاح API ومعرف الصوت والنموذج على /v1/tts.
بعد الإعداد، تستهلك طلبات الكلام RikkaHub رصيد Kitta AI API الخاص بك وتقوم بتشغيل الصوت من خلال المعرف الصوتي المحدد.
ما تحتاجه
- حساب Kitta AI بأرصدة API؛
- مفتاح Kitta AI API؛
- معرف صوتي Kitta AI (
reference_id)؛ - RikkaHub مع مزود الكلام Kitta AI المتوفر.
يعد مفتاح API بمثابة بيانات اعتماد حساسة. لا تشاركها في الدردشة أو لقطات الشاشة أو مواقع الويب غير الموثوقة. قم بإنشاء مفتاح مخصص لـ RikkaHub حتى تتمكن من مراقبته أو إبطاله بشكل منفصل.
الخطوة 1: إنشاء مفتاح Kitta AI API
قم بتسجيل الدخول إلى Kitta AI، وافتح إدارة API، وقم بإنشاء مفتاح لـ RikkaHub. انسخه واحفظه على الفور لأن المفتاح الكامل قد يظهر مرة واحدة فقط.
الخطوة 2: ابحث عن الهوية الصوتية
يرسل RikkaHub المعرف الصوتي كـ reference_id. انسخ واحدة من القائمة الصوتية Kitta AI أو استعلم عن API:
GET /api/open/v1/voices
Authorization: Bearer YOUR_API_KEYلاختبار الاتصال على الفور، ابدأ باستخدام المعرف الصوتي للنظام العام:
00a1b221-6137-4b73-ad62-b0cbce134167استبدله بمعرف الصوت المفضل لديك بعد أن يتمكن RikkaHub من إنشاء الصوت وتشغيله بنجاح.
لا تخلط بين النموذج والصوت:
-
يحدد رأس النموذج إصدار المحرك TTS؛
-
reference_idيختار صوت مكبر الصوت.
الخطوة 3: تكوين موفر Kitta AI في RikkaHub
في RikkaHub، افتح إعدادات الموفر Kitta AI / TTS وأدخل:
| إعداد RikkaHub | القيمة |
|---|---|
| API قاعدة/مضيف نقطة النهاية | https://kittaai.com |
| نقطة النهاية الكاملة (إذا لزم الأمر) | https://kittaai.com/v1/tts |
| مفتاح API | مفتاح Kitta AI API الخاص بك |
| نموذج | s2.1-pro أو s2.1-pro-flash |
صوت / reference_id | 00a1b221-6137-4b73-ad62-b0cbce134167 (استبدل بعد الاختبار) |
| تنسيق | mp3 |
استخدم أسماء الحقول التي يظهرها بناء RikkaHub الخاص بك. الجزء المهم هو أن الطلب يصل إلى POST https://kittaai.com/v1/tts مع:
Authorization: Bearer YOUR_API_KEY
model: s2.1-pro
Content-Type: application/jsonوجسم JSON يتضمن text بالإضافة إلى reference_id غير فارغ.
إذا قام RikkaHub بملء https://api.fish.audio مسبقًا، فاستبدل المضيف بـ https://kittaai.com واحتفظ بـ /v1/tts.
احفظ الموفر، وأنشئ جملة قصيرة واحدة، وتأكد من أن RikkaHub يمكنه تشغيل الصوت الذي تم إرجاعه.
الخطوة 4: قم بتعيين الصوت عند الحاجة
إذا كان RikkaHub يسمح لك باختيار صوت لكل شخصية أو دردشة أو مساعد، فالصق نفس معرف الصوت Kitta AI في هذا الحقل. يمكنك إعادة استخدام تكوين موفر واحد وتغيير reference_id فقط لكل حرف.
استخدام الرصيد API
يستدعي RikkaHub Kitta AI /v1/tts ويستهلك رصيد API المنفصل. يبدأ تحويل النص إلى كلام برصيد API واحد لكل حرف فعال، وقد تطبق بعض النماذج مضاعفًا.
قم بشراء الأرصدة من تسعير API واعرض الرصيد في إدارة API. قد تتضمن الاستجابات الناجحة X-OpenAPI-Credits-Used.
استكشاف الأخطاء وإصلاحها والأسئلة الشائعة
أبلغ RikkaHub عن فشل الاتصال
تأكد من أن المضيف هو https://kittaai.com، وأزل المسافة البيضاء من مفتاح API، وتحقق من أن الحساب لا يزال لديه أرصدة API. لا تدخل كلمة مرور حساب Kitta AI الخاص بك.
يرجع الطلب 400 ويذكر reference_id
يتطلب Kitta AI معرفًا صوتيًا صريحًا. أدخل reference_id صالحًا؛ لن يقوم الخادم باختيار الصوت الافتراضي بصمت.
يرجع الطلب 401 أو يقول أن مفتاح API غير صالح
انسخ المفتاح Kitta AI API مرة أخرى. إذا تم إبطاله، فقم بإنشاء مفتاح جديد واستبدال بيانات الاعتماد المخزنة في RikkaHub.
الطلب يرجع 402 أو يقول أن الرصيد غير كافي
رصيدك الائتماني API منخفض جدًا. أرصدة العضوية وأرصدة API هي أرصدة منفصلة، لذا قم بشراء أرصدة API من صفحة التسعير API.
RikkaHub يتصل ولكن لا يقوم بتشغيل الصوت
اختبر مع mp3 أولاً. إذا طلب العميل opus، فإن Kitta AI يعود إلى mp3 حتى يتمكن مشغلو Android الشائعون من فك تشفير الاستجابة. تأكد أيضًا من صلاحية معرف الصوت وأن إعدادات التشغيل التلقائي أو كتم الصوت لـ RikkaHub لا تمنع التشغيل.
ما هو الموديل الذي يجب أن أختاره؟
ابدأ بـ s2.1-pro أو s2.1-pro-flash. يقوم Kitta AI بتعيين تسميات Fish.audio هذه إلى معرفات طراز المحرك المطابقة. تعمل المعرفات الأصلية مثل fishaudio-s21pro-flash أيضًا في رأس model.