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

إعداد وضع الصوت MCP

قم بتكوين Fish Audio كخدمة TTS متوافقة مع TTS لعملاء Voice Mode وMCP مثل Claude Code.

قم بتوصيل Fish Audio TTS بوضع الصوت MCP

يضيف الوضع الصوتي محادثات صوتية ثنائية الاتجاه إلى Claude Code وعملاء MCP الآخرين. أضف نقطة النهاية المتوافقة مع Fish Audio OpenAI إلى قائمة خدمات TTS الخاصة بها.

تكوين متغيرات البيئة

أضف هذه القيم إلى كتلة env الخاصة بخادم MCP:

{
  "OPENAI_API_KEY": "YOUR_API_KEY",
  "VOICEMODE_TTS_BASE_URLS": "https://fishaudio.org/v1",
  "VOICEMODE_TTS_MODEL": "fishaudio-s21pro-flash",
  "VOICEMODE_TTS_VOICE": "00a1b221-6137-4b73-ad62-b0cbce134167"
}

بدلاً من ذلك، ضعها في ~/.voicemode/voicemode.env:

export OPENAI_API_KEY="YOUR_API_KEY"
export VOICEMODE_TTS_BASE_URLS="https://fishaudio.org/v1"
export VOICEMODE_TTS_MODEL="fishaudio-s21pro-flash"
export VOICEMODE_TTS_VOICE="00a1b221-6137-4b73-ad62-b0cbce134167"

تظل المتغيرات القديمة TTS_BASE_URL وTTS_MODEL وTTS_VOICE مدعومة، ولكن يجب أن تستخدم التكوينات الجديدة أسماء VOICEMODE_.

اختبار وتغيير الصوت

أعد تشغيل عميل MCP حتى يقوم خادم Voice Mode بإعادة تحميل بيئته. ابدأ محادثة صوتية قصيرة، ثم استبدل الصوت الاختباري بـ [الهوية الصوتية] المفضلة لديك (/ar/docs/api-reference/voices/list).

عند تكوين عناوين URL متعددة لـ TTS، يمكن أن يقوم وضع الصوت بتجربة الخدمات الاحتياطية بالتسلسل. احتفظ فقط بـ https://fishaudio.org/v1 أثناء استكشاف الأخطاء وإصلاحها.

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

  • يتم استخدام خدمة أخرى: قم بإزالة الإدخالات الأخرى من VOICEMODE_TTS_BASE_URLS أثناء الاختبار.
  • مفتاح API مفقود: تأكد من أن المتغير متاح للعملية التي تبدأ خادم MCP.
  • نموذج أو صوت غير صالح: استخدم معرفات Fish Audio بدلاً من إعدادات OpenAI الافتراضية.
  • 401/402: التحقق من المفتاح ورصيد API الائتماني.

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