Fish Audio API를 통해 MP3 음성 파일을 생성하는 베타 WorkBuddy Skill을 설치합니다.

Fish Audio TTS를 WorkBuddy에 연결합니다.

Tencent WorkBuddy는 맞춤형 Skill을 통해 외부 API를 호출할 수 있습니다. WorkBuddy 작업에서 MP3 파일을 생성하려면 Fish Audio 스킬을 사용하세요.

WorkBuddy의 스킬 가져오기 및 권한 UI가 데스크톱 버전에 따라 다를 수 있으므로 이 통합은 베타 버전입니다. 설정 → 모델에서 Fish Audio를 구성하지 마십시오. 해당 화면에는 Fish Audio 음성 엔드포인트가 아닌 /chat/completions와 같은 채팅 모델 엔드포인트가 필요합니다.

시작하기 전에

당신은 다음이 필요합니다

API 크레딧이 포함된 Fish Audio API 키
WorkBuddy에서 사용 가능한 Python 3.9 이상
로컬 스크립트를 실행하고 네트워크에 접근하기 위한 스킬에 대한 권한입니다.

독립적으로 모니터링하고 취소할 수 있도록 WorkBuddy용 전용 API 키를 만듭니다.

스킬 다운로드

Fish Audio TTS 스킬 패키지를 다운로드하고 압축을 해제하세요. 패키지에는 SKILL.md, skill.yml, Python 구현 및 README가 포함되어 있습니다.

WorkBuddy 버전은 현재 다음 설치 흐름 중 하나를 사용합니다.

스킬을 열고 가져오기 또는 로컬 스킬 작업을 선택한 다음 추출된 폴더를 선택합니다.
사용 중인 버전에 가져오기 작업이 표시되지 않으면 WorkBuddy에게 추출된 폴더를 사용자 지정 스킬로 설치하도록 요청하는 작업을 만듭니다.

Skill을 활성화하기 전에 WorkBuddy에 표시된 파일과 권한을 검토하세요.

자격 증명 구성

WorkBuddy를 시작하는 환경에서 키를 설정합니다.

export FISH_AUDIO_BASE_URL="https://fishaudio.org/v1"
export FISH_AUDIO_API_KEY="YOUR_FISH_AUDIO_API_KEY"
export FISH_AUDIO_VOICE_ID="00a1b221-6137-4b73-ad62-b0cbce134167"
export FISH_AUDIO_MODEL="fishaudio-s21pro-flash"

macOS에서는 터미널에 설정된 환경 변수가 Finder에서 시작된 앱에 자동으로 사용되지 않습니다. WorkBuddy 버전의 로컬 비밀 또는 환경 구성 흐름을 따르거나 이러한 변수가 포함된 환경에서 앱을 시작하세요.

API 키를 WorkBuddy 대화에 붙여넣거나 Skill 폴더에 저장하지 마세요.

스킬 테스트

새로운 WorkBuddy 작업을 시작하고 다음과 같이 질문하십시오.

Use the Fish Audio TTS Skill to create an MP3 file that says:
"Hello, this is a Fish Audio test."
Save it as fish-audio-test.mp3.

WorkBuddy가 출력 경로를 보고하고 MP3가 재생되는지 확인합니다. 그런 다음 테스트 음성 ID를 원하는 Fish Audio 음성 ID로 바꾸세요.

문제 해결

스킬이 발견되지 않음: 추출된 폴더의 루트에 SKILL.md가 포함되어 있는지 확인한 후 WorkBuddy를 다시 가져오거나 다시 시작하세요.
Python 또는 터미널 권한이 거부되었습니다: 이 스킬에 필요한 로컬 실행 권한만 활성화합니다.
API 키가 누락되었습니다: FISH_AUDIO_API_KEY를 WorkBuddy 프로세스에 노출합니다. 스킬 파일에 추가하지 마십시오.
401/402: API 키를 교체하거나 API 크레딧을 추가하세요.
MP3가 생성되지 않음: HTTP 상태 및 응답 본문에 대한 작업 출력을 검사하고 출력 디렉터리가 쓰기 가능한지 확인합니다.

베타 지원 경계

포함된 스크립트와 Fish Audio API 요청은 독립적으로 테스트 가능합니다. 사용하는 WorkBuddy 데스크톱 버전에 대해 정확한 스킬 가져오기 화면과 비밀 로딩 동작을 계속 확인해야 합니다. 설치에 실패하면 지원팀에 문의할 때 WorkBuddy 버전, 운영 체제 및 표시되는 오류 메시지를 포함하세요.

WorkBuddy 설정(베타)