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