RimTalk TTS 설정 가이드
비공식 RimTalk TTS 모드에 Fish Audio OpenAI 호환 공급자를 추가하고 RimWorld 정착민마다 다른 음성을 지정합니다.
RimTalk TTS에 Fish Audio 연결하기
RimTalk TTS는 사용자 지정 OpenAI 호환 공급자로 Fish Audio를 호출하여 각 RimWorld 정착민의 대사를 지정한 음성으로 읽을 수 있습니다.
RimTalk 버전을 먼저 확인하세요
설정 화면에 **Custom TTS Providers (Untested!)**와 새 공급자 추가 항목이 있어야 합니다. 이 기능은 현재 업스트림 개발 버전에 포함되어 있습니다. 해당 항목이 없다면 모드의 출처와 버전을 먼저 확인하세요.
준비 사항
RimTalk 전용 API 키와 Fish Audio Voice ID를 준비합니다. 전체 키를 공개 스크린샷, 채팅 또는 모드 파일에 넣지 마세요. 이미 노출된 키는 즉시 폐기해야 합니다.
첫 연결 테스트에는 다음 시스템 음성을 사용할 수 있습니다.
00a1b221-6137-4b73-ad62-b0cbce134167사용자 지정 공급자 추가
TTS Configuration → Custom TTS Providers → Add New Custom Provider를 열고 다음 값을 입력합니다.
| 항목 | 값 |
|---|---|
| Provider name | Fish Audio |
| Base URL | https://fishaudio.org/v1 |
| Endpoint path | /audio/speech |
| Model | fishaudio-s21pro-flash |
| Default voice | 00a1b221-6137-4b73-ad62-b0cbce134167 |
| Response format | mp3 |
| Auth header name | Authorization |
| Auth header prefix | Bearer 뒤에 공백 한 칸 |
| Timeout | 60초 |
전체 URL은 https://fishaudio.org/v1/audio/speech여야 합니다. speed는 켜고 streaming, temperature, top_p, 감정 필드와 사용자 지정 요청 본문은 끕니다.
tts-1, alloy, 이전 공급자의 s2.1-pro를 사용하지 마세요. 엔진 모델과 음성 UUID는 서로 다른 필드입니다.
정착민에게 음성 지정
저장한 뒤 새 사용자 지정 공급자를 선택합니다. 음성 모델 목록에 알아보기 쉬운 이름을 추가하고 Model ID에는 Fish Audio 음성 UUID를 붙여 넣습니다. 기본 음성을 고른 다음 각 Pawn에 알맞은 음성을 지정합니다.
테스트와 문제 해결
먼저 정착민 한 명에게 짧은 문장을 읽게 하세요. HTTP 200, 전체 MP3 재생, API 관리 화면의 사용량을 확인합니다.
- 401: 키와
Bearer뒤 공백을 확인합니다. - 402: API 크레딧을 충전합니다.
- 404: Base URL은
/v1까지, 경로는/audio/speech만 입력합니다. - 400: 모델과 음성 UUID를 확인합니다.
- 시간 초과: flash 모델, 60초, 짧은 문장을 사용합니다.
- 429: 생성 간격을 유지하고 동시 요청 수를 줄입니다.
RimTalk는 동기 오디오 응답을 기다리며 비동기 작업을 조회하지 않습니다. 지나치게 긴 입력은 줄여 주세요.