RikkaHub의 Fish Audio 제공자를 호환 /v1/tts 엔드포인트로 설정하고 Voice ID와 모델을 지정합니다.

Fish Audio TTS를 RikkaHub에 연결하기

RikkaHub에서 Fish Audio 음성 제공자를 선택한 뒤 API 베이스를 api.fish.audio 대신 Fish Audio로 지정하고, API 키·Voice ID·모델을 /v1/tts에 맞게 설정하세요.

설정 후 RikkaHub 음성 요청은 Fish Audio API 크레딧 잔액을 사용하고 선택한 음성 ID를 통해 오디오를 재생합니다.

필요한 것

API 크레딧이 있는 Fish Audio 계정
Fish Audio API 키;
Fish Audio 음성 ID(reference_id)
Fish Audio 음성 제공자를 갖춘 RikkaHub를 사용할 수 있습니다.

API 키는 민감한 자격 증명입니다. 채팅, 스크린샷, 신뢰할 수 없는 웹사이트에 공유하지 마세요. 별도로 모니터링하거나 취소할 수 있도록 RikkaHub 전용 키를 생성하세요.

1단계: Fish Audio API 키 생성

Fish Audio에 로그인하고 API 관리를 열고 RikkaHub에 대한 키를 만듭니다. 전체 키는 한 번만 표시될 수 있으므로 즉시 복사하여 저장하세요.

2단계: 음성 ID 찾기

RikkaHub는 음성 ID를 reference_id로 보냅니다. Fish Audio 음성 목록에서 하나를 복사하거나 API에 쿼리하세요.

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

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

00a1b221-6137-4b73-ad62-b0cbce134167

RikkaHub가 오디오를 성공적으로 생성하고 재생할 수 있게 되면 원하는 음성 ID로 바꾸세요.

모델과 음성을 혼동하지 마십시오.

모델 헤더는 TTS 엔진 버전을 선택합니다.
reference_id는 스피커 음성을 선택합니다.
사용 가능한 음성 목록
맞춤 음성 만들기

3단계: RikkaHub에서 Fish Audio 공급자 구성

RikkaHub에서 Fish Audio / TTS 공급자 설정을 열고 다음을 입력합니다.

RikkaHub 설정	가치
API 베이스/엔드포인트 호스트	`https://fishaudio.org`
전체 끝점(필요한 경우)	`https://fishaudio.org/v1/tts`
API 키	귀하의 Fish Audio API 키
모델	`s2.1-pro` 또는 `s2.1-pro-flash`
음성 / `reference_id`	`00a1b221-6137-4b73-ad62-b0cbce134167`(테스트 후 교체)
형식	`mp3`

RikkaHub 빌드에 표시되는 필드 이름을 사용하세요. 중요한 부분은 요청이 다음을 통해 POST https://fishaudio.org/v1/tts에 도달한다는 것입니다.

Authorization: Bearer YOUR_API_KEY
model: s2.1-pro
Content-Type: application/json

text와 비어 있지 않은 reference_id를 포함하는 JSON 본체.

RikkaHub가 https://api.fish.audio를 미리 채우는 경우 호스트를 https://fishaudio.org로 교체하고 /v1/tts를 유지합니다.

공급자를 저장하고 짧은 문장 하나를 생성한 다음 RikkaHub가 반환된 오디오를 재생할 수 있는지 확인합니다.

4단계: 필요한 곳에 음성 할당

RikkaHub를 통해 캐릭터, 채팅 또는 보조자별로 음성을 선택할 수 있는 경우 동일한 Fish Audio 음성 ID를 해당 필드에 붙여넣습니다. 하나의 공급자 구성을 재사용할 수 있으며 문자당 reference_id만 변경할 수 있습니다.

API 크레딧 사용량

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

API 가격에서 크레딧을 구매하고 API 관리에서 잔액을 확인하세요. 성공적인 응답에는 X-OpenAPI-Credits-Used가 포함될 수 있습니다.

문제 해결 및 FAQ

RikkaHub에서 연결 실패를 보고합니다.

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

요청은 400을 반환하고 `reference_id`를 언급합니다.

Fish Audio에는 명시적인 음성 ID가 필요합니다. 유효한 reference_id를 입력하세요. 서버는 기본 음성을 자동으로 선택하지 않습니다.

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

Fish Audio API 키를 다시 복사합니다. 취소된 경우 새 키를 생성하고 RikkaHub에 저장된 자격 증명을 교체합니다.

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

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

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

먼저 mp3로 테스트하세요. 클라이언트가 opus를 요청한 경우 Fish Audio는 일반 Android 플레이어가 응답을 디코딩할 수 있도록 mp3로 대체됩니다. 또한 음성 ID가 유효한지, RikkaHub 자동 재생 또는 음소거 설정이 재생을 차단하고 있지 않은지 확인하세요.

어떤 모델을 선택해야 하나요?

s2.1-pro 또는 s2.1-pro-flash로 시작하세요. Fish Audio는 이러한 fish.audio 레이블을 일치하는 엔진 모델 ID에 매핑합니다. fishaudio-s21pro-flash와 같은 기본 ID는 model 헤더에서도 작동합니다.

RikkaHub 설정 가이드