통합 가이드타사 통합
코즈 설정
Coze 워크플로에서 Fish Audio OpenAI 호환 TTS API를 호출하고 생성된 음성을 봇이나 앱에 반환합니다.
Fish Audio TTS를 코즈에 연결
Coze 워크플로에서 HTTP 요청 노드를 사용하여 봇에서 생성된 텍스트를 Fish Audio 음성으로 변환합니다. 엔드포인트는 OpenAI 호환 TTS 요청 형식을 따릅니다.
시작하기 전에
- 전용 Fish Audio API 키를 생성합니다.
- 음성 라이브러리에서 Fish Audio 음성 ID를 복사합니다.
- 텍스트 입력을 수신하는 Coze 워크플로를 생성하거나 엽니다.
HTTP 요청 구성
텍스트 생성 노드 뒤에 HTTP 요청 노드를 추가하고 다음 설정을 사용합니다.
| 설정 | 가치 |
|---|---|
| 방법 | POST |
| URL | https://fishaudio.org/v1/audio/speech |
| 헤더 | Authorization: Bearer YOUR_FISH_AUDIO_API_KEY |
| 헤더 | Content-Type: application/json |
이 JSON 본체를 사용하십시오.
{
"model": "fishaudio-s21pro-flash",
"voice": "00a1b221-6137-4b73-ad62-b0cbce134167",
"input": "{{text}}",
"response_format": "mp3"
}{{text}}를 봇 응답이 포함된 워크플로 변수에 매핑합니다. 노드 응답을 파일 또는 바이너리 출력으로 구성한 다음 워크플로에서 해당 출력을 반환합니다.
작업 흐름 테스트
먼저 짧은 문장으로 워크플로를 실행하세요. 워크플로를 게시된 봇 또는 앱에 연결하기 전에 HTTP 노드가 MP3 파일을 반환하는지 확인하세요.
문제 해결
- 401: Authorization 헤더가
Bearer로 시작하고 Fish Audio API 키를 사용하는지 확인합니다. - 402: API 크레딧을 추가합니다. 멤버십 크레딧과 API 크레딧은 별도의 잔액입니다.
- 오디오 출력 없음: HTTP 응답을 JSON 대신 파일 또는 이진 값으로 구성합니다.
- 잘못된 음성: 예시 음성 ID를 유효한 시스템 또는 사용자 정의 Fish Audio 음성 ID로 바꿉니다.
- 요청 시간 초과: 더 짧은 입력으로 테스트하고 각 요청이 한 단락에 집중되도록 합니다.