Kitta AI Docs
整合指南第三方集成
返回主站

OpenTalking 接入教學

在 OpenTalking 中設定 OpenAI 相容的 TTS 提供者以使用 Kitta AI 模型和克隆語音。

將 Kitta AI TTS 連接到 OpenTalking

OpenTalking 包含一個用於語音對話和產生媒體的 openai_compatible TTS 提供者。其 TTS 提供者與其 LLM 和語音辨識提供者是分開的。

準備 API Key 和 Voice ID

  1. API 管理頁面建立此軟體專用的 API Key。
  2. 開啟自己的複製音色並複製 Voice ID。
  3. 確認 API 點數餘額充足。

使用此系統語音進行第一次測試:

00a1b221-6137-4b73-ad62-b0cbce134167

設定 OpenTalking

在 OpenTalking 的後端 .env 檔案中新增或更新這些值:

OPENTALKING_TTS_DEFAULT_PROVIDER=openai_compatible
OPENTALKING_TTS_OPENAI_BASE_URL=https://kittaai.com/v1
OPENTALKING_TTS_OPENAI_API_KEY=YOUR_FISH_AUDIO_API_KEY
OPENTALKING_TTS_OPENAI_MODEL=fishaudio-s21pro-flash
OPENTALKING_TTS_OPENAI_VOICE=00a1b221-6137-4b73-ad62-b0cbce134167
OPENTALKING_TTS_OPENAI_RESPONSE_FORMAT=wav
OPENTALKING_TTS_OPENAI_PROTOCOL=audio_speech

如果 OPENTALKING_TTS_ENABLED_PROVIDERS 已設置,請確保其逗號分隔清單包含 openai_compatible

Base URL 只填寫到 /v1

OpenTalking 會在 OPENTALKING_TTS_OPENAI_BASE_URL 後自動附加 /audio/speech。不要在此變數中填寫完整的 /v1/audio/speech 端點。

更改 .env 後重新啟動 OpenTalking 後端。在“設定”中,選擇“OpenAI相容TTS”,輸入簡短的預覽句子,然後播放語音預覽。

提供者邊界

  • 這些設定僅更改 TTS。分別配置 LLM 和 ASR 提供者。
  • 保留 audio_speech 作為協議。 Kitta AI 不是聊天完成音訊提供者。
  • 使用 wav 進行第一次測試,因為 OpenTalking 的轉接器在將音訊串流傳輸到對話之前直接解碼 WAV。
  • 僅在預覽正常後,才用您的複製語音取代系統語音 ID。

故障排除

  • 404:使用 https://kittaai.com/v1 作為基本 URL; OpenTalking 新增了 /audio/speech
  • 401:驗證OPENTALKING_TTS_OPENAI_API_KEY,然後重新啟動後端。
  • 402:在重試之前加入 API 積分。
  • 400 或無效語音:使用 fishaudio-s21pro-flash 和有效的 Kitta AI 語音 ID。
  • OpenAI相容TTS不可用:將openai_compatible加入到OPENTALKING_TTS_ENABLED_PROVIDERS並重新啟動。
  • 設定更改,但音訊未更改:OpenTalking 將執行時間配置保留到後端環境;確認顯示的型號和語音,然後重新啟動受影響的服務。

相關文檔