Kitta Audio Docs
통합 가이드타사 통합
Back to site

Tavo 설정 가이드

Tavo에서 Kitta Audio를 사용자 정의 OpenAI 호환 TTS 공급자로 구성한 다음 Kitta Audio 음성을 캐릭터에 할당하세요.

Kitta Audio TTS를 Tavo에 연결합니다.

이 가이드는 Tavo에서 Kitta Audio를 사용자 정의 OpenAI 호환 TTS 공급자로 구성하고 Kitta Audio 음성을 캐릭터에 할당하는 방법을 보여줍니다. 설정 후 Tavo는 선택한 음성으로 문자 메시지를 읽을 수 있습니다.

필요한 것

  1. API 크레딧이 있는 Kitta Audio 계정
  2. Kitta Audio API 키;
  3. 사용하려는 Kitta Audio 음성 ID;
  4. 작동 중인 Tavo 설치.

API 키는 민감한 자격 증명입니다. 다른 사람에게 보내거나 채팅 메시지, 공개 스크린샷 또는 신뢰할 수 없는 웹사이트에 포함하지 마세요. Tavo 전용 키를 생성하여 별도로 모니터링하거나 철회할 수 있습니다.

1단계: Kitta Audio API 키 생성

Kitta Audio에 로그인하고 API 관리를 열고 Tavo용 키를 생성하세요. 전체 키는 한 번만 표시될 수 있으므로 즉시 복사하여 저장하세요.

2단계: 음성 ID 찾기

Tavo가 특정 음성과 음성을 합성하려면 음성 ID가 필요합니다. Kitta Audio 음성 목록에서 하나를 복사하거나 API에 쿼리하세요.

연결을 즉시 테스트하려면 다음 공개 시스템 음성 ID로 시작하세요.

00a1b221-6137-4b73-ad62-b0cbce134167

초기 연결 테스트에 사용하고, Tavo가 오디오를 성공적으로 생성하고 재생할 수 있게 되면 선호하는 Voice ID로 교체하세요.

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

모델과 음성 필드를 혼동하지 마십시오. 모델은 TTS 엔진을 선택하고 음성 ID는 스피커 사운드를 선택합니다.

3단계: Tavo에 음성 API 추가

Tavo에서 다음을 엽니다.

More → Voice & Image Generation → Voice API → New

TTS 사용자 정의 OpenAI 프로토콜 모델을 선택한 후 다음을 입력합니다.

타보 설정가치
API 기본 URLhttps://fishaudio.org/v1
API 키귀하의 Kitta Audio API 키
모델 IDfishaudio-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가 Voice ID를 요청하면 동일한 Kitta Audio Voice ID를 다시 입력하세요. 바인딩을 저장하고, 채팅으로 돌아가서 짧은 메시지를 보내고, 음성 재생을 시작하세요.

각 캐릭터에 다른 Kitta Audio 음성을 할당할 수 있습니다. 공급자 설정을 재사용하고 각 문자 바인딩에서 음성 ID만 변경합니다.

API 크레딧 사용량

Tavo는 Kitta Audio /v1/audio/speech를 통해 음성을 생성하고 별도의 API 크레딧 잔액을 소비합니다. 텍스트 음성 변환은 유효 문자당 1 API 크레딧부터 시작하며 일부 모델은 승수를 적용할 수 있습니다.

API 가격에서 크레딧을 구매하고 API 관리에서 잔액을 확인하세요. 실제 요청 비용은 X-OpenAPI-Credits-Used로 반환됩니다.

문제 해결 및 FAQ

Tavo가 연결 실패를 보고합니다.

기본 URL이 https://fishaudio.org/v1인지 확인하고, API 키에서 공백을 제거하고, 계정에 여전히 API 크레딧이 있는지 확인하세요. Kitta Audio 계정 비밀번호를 입력하지 마세요.

요청이 401을 반환하거나 API 키가 유효하지 않다고 말합니다.

Kitta Audio API 키를 다시 복사합니다. 취소된 경우 새 키를 생성하고 Tavo에 저장된 이전 자격 증명을 교체하세요.

요청에서 402를 반환하거나 잔액이 부족하다고 표시됩니다.

API 크레딧 잔액이 너무 낮습니다. 멤버십 크레딧과 API 크레딧은 별도의 잔액이므로 API 가격 페이지에서 API 크레딧을 구매하세요.

Tavo가 연결되지만 오디오가 재생되지 않습니다

캐릭터가 음성 API에 바인딩되어 있고 음성 ID가 유효한지 확인하세요. 먼저 mp3로 짧은 문장을 테스트한 후 Tavo의 자동 재생, 음소거 및 배경 재생 설정을 확인하세요.

타보가 모델이나 음성이 유효하지 않다고 합니다

모델 ID로 fishaudio-s21pro-flash를 사용하고 음성으로 Kitta Audio 음성 ID를 사용합니다. tts-1alloy와 같은 OpenAI 이름은 Kitta Audio 모델 또는 음성에 자동으로 매핑되지 않습니다.

캐릭터마다 다른 목소리를 사용할 수 있나요?

예. 각 캐릭터에 일치하는 Kitta Audio 보이스 ID를 입력하면 캐릭터마다 다른 목소리를 낼 수 있습니다.

관련 문서