دليل إعداد RimTalk TTS
أضف Fish Audio كمزوّد متوافق مع OpenAI في RimTalk TTS وعيّن صوتا مختلفا لكل مستعمر في RimWorld.
ربط Fish Audio TTS مع RimTalk
يستطيع RimTalk TTS استدعاء Fish Audio من خلال مزوّد مخصص متوافق مع OpenAI لقراءة حوار كل مستعمر بالصوت المحدد له.
تحقق من إصدار RimTalk أولا
يجب أن تعرض صفحة الإعدادات Custom TTS Providers (Untested!) وخيار إضافة مزوّد جديد. تتوفر هذه الميزة حاليا في نسخة التطوير للمشروع. إذا لم تظهر، فتحقق من مصدر المود وإصداره قبل المتابعة.
المتطلبات
أنشئ مفتاح API مستقلا لـ RimTalk واحصل على Voice ID من Fish Audio. لا تنشر المفتاح الكامل في لقطة شاشة أو محادثة أو ملفات المود. ألغ أي مفتاح سبق كشفه.
يمكن استعمال صوت النظام التالي للاختبار الأول:
00a1b221-6137-4b73-ad62-b0cbce134167إضافة المزوّد
افتح TTS Configuration → Custom TTS Providers → Add New Custom Provider وأدخل القيم التالية:
| الحقل | القيمة |
|---|---|
| Provider name | Fish Audio |
| Base URL | https://fishaudio.org/v1 |
| Endpoint path | /audio/speech |
| Model | fishaudio-s21pro-flash |
| Default voice | 00a1b221-6137-4b73-ad62-b0cbce134167 |
| Response format | mp3 |
| Auth header name | Authorization |
| Auth header prefix | Bearer ثم مسافة واحدة |
| Timeout | 60 ثانية |
يجب أن يكون العنوان الكامل https://fishaudio.org/v1/audio/speech. فعّل speed واترك streaming وtemperature وtop_p وحقول المشاعر ونص الطلب المخصص معطلة.
لا تستخدم tts-1 أو alloy أو القيمة القديمة s2.1-pro. معرّف نموذج المحرك وUUID الخاص بالصوت حقلان مختلفان.
تعيين الأصوات للمستعمرين
احفظ المزوّد الجديد وحدده. أضف اسما واضحا في قائمة نماذج الصوت، والصق UUID لصوت Fish Audio في Model ID. اختر الصوت الافتراضي ثم عيّن الصوت المناسب لكل Pawn.
الاختبار وحل المشكلات
ابدأ بجملة قصيرة من مستعمر واحد. تحقق من استجابة HTTP 200 وتشغيل ملف MP3 كاملا وظهور الاستهلاك في إدارة API.
- 401: تحقق من المفتاح والمسافة بعد
Bearer. - 402: أضف رصيد API.
- 404: ينتهي Base URL عند
/v1ويكون المسار/audio/speechفقط. - 400: تحقق من النموذج وUUID للصوت.
- انتهاء المهلة: استخدم نموذج flash ومهلة 60 ثانية ونصا قصيرا.
- 429: أبق فترة التهدئة وقلل الطلبات المتزامنة.
ينتظر RimTalk استجابة صوتية متزامنة ولا يستعلم عن المهام غير المتزامنة؛ اختصر النص الطويل.