빠른 시작

이 페이지는 실제 텍스트 음성 변환 요청을 신속하게 완료하는 데 도움이 됩니다. 동기식 TTS로 시작하세요. 오디오를 직접 반환하고 테스트하기 가장 쉬운 경로이기 때문입니다.

1. API 키 생성

Fish Audio 계정에서 API 키를 생성합니다.

전체 API 키는 한 번만 표시됩니다. 서버 측 환경 변수에 저장하십시오. 브라우저 코드, 모바일 앱 또는 공개 저장소로 제공하지 마십시오.

export FISHAUDIO_API_KEY="YOUR_API_KEY"

2. 목소리를 선택하세요

귀하의 계정에서 사용할 수 있는 음성을 나열하십시오.

curl "https://fishaudio.org/api/open/v1/voices" \
  -H "Authorization: Bearer $FISHAUDIO_API_KEY"

반환된 음성 ID를 복사하여 voiceId로 사용합니다. 연결을 즉시 테스트하려면 공용 시스템 테스트 음성 00a1b221-6137-4b73-ad62-b0cbce134167를 사용한 후 나중에 원하는 음성으로 바꾸세요.

3. 음성 생성

curl -X POST "https://fishaudio.org/api/open/v1/speech/tts" \
  -H "Authorization: Bearer $FISHAUDIO_API_KEY" \
  -H "Content-Type: application/json" \
  -o speech.audio \
  -d '{
    "text": "Hello from Fish Audio.",
    "voiceId": "00a1b221-6137-4b73-ad62-b0cbce134167"
  }'

요청이 성공하면 speech.audio가 현재 디렉터리에 저장됩니다. 응답 Content-Type 헤더를 사용하여 최종 파일 확장자를 선택하세요.

다음 단계

필요	읽기
동기화, 비동기 또는 일괄 처리 흐름 선택	API 선택
엔드포인트 계약 읽기	API 참조
인증 이해	인증
음성 생성	텍스트 음성 변환
브라우저에서 요청 테스트	API 플레이그라운드