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

دليل إعداد تافو

قم بتكوين Fish Audio كموفر TTS مخصص متوافق مع TTS في Tavo، ثم قم بتعيين أصوات Fish Audio لشخصياتك.

قم بتوصيل Fish Audio TTS إلى Tavo

يوضح هذا الدليل كيفية تكوين Fish Audio كموفر OpenAI مخصص متوافق مع TTS في Tavo وتعيين صوت Fish Audio لشخصية ما. بعد الإعداد، يستطيع Tavo قراءة رسائل الشخصيات بصوتك المحدد.

ما تحتاجه

  1. حساب Fish Audio بأرصدة API؛
  2. مفتاح Fish Audio API؛
  3. معرف الصوت Fish Audio الذي تريد استخدامه؛
  4. تركيب تافو صالح للعمل.

يعد مفتاح API بمثابة بيانات اعتماد حساسة. لا ترسلها إلى أشخاص آخرين أو تدرجها في رسائل الدردشة أو لقطات الشاشة العامة أو مواقع الويب غير الموثوق بها. قم بإنشاء مفتاح مخصص لـ Tavo حتى تتمكن من مراقبته أو إبطاله بشكل منفصل.

الخطوة 1: إنشاء مفتاح Fish Audio API

قم بتسجيل الدخول إلى Fish Audio، وافتح إدارة API، وقم بإنشاء مفتاح لـ Tavo. انسخه واحفظه على الفور لأن المفتاح الكامل قد يظهر مرة واحدة فقط.

الخطوة 2: ابحث عن الهوية الصوتية

يحتاج Tavo إلى معرف صوتي لتجميع الكلام بصوت معين. انسخ واحدة من قائمة الأصوات Fish Audio أو استعلم عن API:

لاختبار الاتصال على الفور، ابدأ باستخدام المعرف الصوتي للنظام العام:

00a1b221-6137-4b73-ad62-b0cbce134167

استخدمه لاختبار الاتصال الأولي، ثم استبدله بالمعرف الصوتي المفضل لديك بعد أن يتمكن Tavo من إنشاء الصوت وتشغيله بنجاح.

GET /api/open/v1/voices
Authorization: Bearer YOUR_API_KEY

لا تخلط بين حقلي النموذج والصوت: يختار النموذج محرك TTS، بينما يختار Voice ID صوت مكبر الصوت.

الخطوة 3: إضافة صوت API في Tavo

في تافو، افتح:

More → Voice & Image Generation → Voice API → New

اختر TTS نموذج بروتوكول OpenAI المخصص، ثم أدخل:

إعداد تافوالقيمة
عنوان URL الأساسي APIhttps://fishaudio.org/v1
مفتاح APIمفتاح Fish Audio API الخاص بك
معرف النموذجfishaudio-s21pro-flash
الهوية الصوتية00a1b221-6137-4b73-ad62-b0cbce134167 (استبدل بعد الاختبار)
تنسيق الصوتmp3

يجب أن ينتهي عنوان URL الأساسي عند /v1. لا تقم بإلحاق /audio/speech؛ يضيف Tavo مسار /v1/audio/speech الكامل عندما يرسل طلبًا.

احفظ المزود. إذا قدم Tavo اختبار اتصال، فقم بإنشاء جملة قصيرة واحدة وتأكد من تشغيل الصوت.

الخطوة 4: تعيين الصوت لشخصية ما

بعد إنشاء الصوت API، افتح شاشة الربط الصوتي لشخصية Tavo:

Character Voice Binding → Select Character → Select Your Voice API

إذا طلب Tavo معرفًا صوتيًا، فأدخل نفس معرف الصوت Fish Audio مرة أخرى. احفظ الرابط، وارجع إلى الدردشة، وأرسل رسالة قصيرة، وابدأ تشغيل الصوت.

يمكنك تخصيص صوت Fish Audio مختلف لكل شخصية. أعد استخدام إعدادات الموفر وقم بتغيير المعرف الصوتي فقط في كل رابط للأحرف.

استخدام الرصيد API

يقوم Tavo بإنشاء الكلام من خلال Fish Audio /v1/audio/speech ويستهلك رصيد API المنفصل. تبدأ ميزة تحويل النص إلى كلام برصيد API واحد لكل حرف فعال، وقد تطبق بعض النماذج مضاعفًا.

قم بشراء الأرصدة من تسعير API واعرض الرصيد في إدارة API. يتم إرجاع تكلفة الطلب الفعلية في X-OpenAPI-Credits-Used.

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

تقارير Tavo عن فشل الاتصال

تأكد من أن عنوان URL الأساسي هو https://fishaudio.org/v1، وقم بإزالة المسافة البيضاء من مفتاح API، وتحقق من أن الحساب لا يزال لديه أرصدة API. لا تدخل كلمة مرور حساب Fish Audio الخاص بك.

يرجع الطلب 401 أو يقول أن مفتاح API غير صالح

انسخ المفتاح Fish Audio API مرة أخرى. إذا تم إبطاله، فقم بإنشاء مفتاح جديد واستبدال بيانات الاعتماد القديمة المخزنة في Tavo.

الطلب يرجع 402 أو يقول أن الرصيد غير كافي

رصيدك الائتماني API منخفض جدًا. أرصدة العضوية وأرصدة API هي أرصدة منفصلة، ​​لذا قم بشراء أرصدة API من صفحة تسعير API.

يتصل Tavo ولكن لا يقوم بتشغيل الصوت

تحقق من أن الحرف مرتبط بالصوت API وأن المعرف الصوتي صالح. اختبر جملة قصيرة باستخدام mp3 أولاً، ثم تحقق من إعدادات التشغيل التلقائي وكتم الصوت وتشغيل الخلفية في Tavo.

يقول تافو أن النموذج أو الصوت غير صالح

استخدم fishaudio-s21pro-flash كمعرف النموذج ومعرف الصوت Fish Audio كصوت. لا يتم تعيين أسماء OpenAI مثل tts-1 وalloy تلقائيًا إلى نماذج أو أصوات Fish Audio.

هل يمكن لكل شخصية استخدام صوت مختلف؟

نعم. أدخل معرف الصوت Fish Audio المطابق لكل حرف لمنح الشخصيات أصواتًا مختلفة.

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