텍스트 음성 변환 (HTTP)
음성 클론 - 모델 생성
립싱크 - 작업 생성
사용자 프로필
텍스트 음성 변환 (HTTP)
음성 클론 - 모델 생성
립싱크 - 작업 생성
사용자 프로필
텍스트 음성 변환 (HTTP) (HTTP)
음성 모델 ID와 엔진 옵션으로 REST 음성을 합성합니다.
텍스트 음성 변환 (HTTP)
엔드포인트
POST /api/open/v1/speech/tts
요청 헤더
// 요청 파라미터 Content-Type: application/json Authorization: Bearer YOUR_API_KEY // API 키 // 요청 파라미터 Content-Type: application/msgpack Authorization: Bearer YOUR_API_KEY // API 키
요청 파라미터
예시 요청 파라미터
사용 가능한 옵션:
- • 텍스트 음성 변환 (HTTP): v1, v2, s1
- • 텍스트 음성 변환 (HTTP v2): v3-turbo, v3-hd
- • 선택: 음성 ID와 선택적 엔진 설정으로 음성을 합성합니다.
응답 데이터
// 응답 데이터 (cache=false) - 200
Content-Type: audio/mpeg
<다양한 형식>
// 응답 데이터 (cache=true) - 200
Content-Type: application/json
{
"success": boolean, // 응답 데이터
"audio_url": string, // 음성을 텍스트로
"format": string, // 다양한 형식
"characters_used": number, // 요청 파라미터
"quota_remaining": number // API 잔여량과 기본 계정 정보를 확인합니다.
}
// 조회 실패
{
"error": string // 조회 실패
}CURL 예시
# 요청 파라미터 - 선택
curl -X POST https://fishaudio.org/api/open/v1/speech/tts \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"voiceId": "your_voice_id",
"modelId": "fishaudio-s21pro-flash",
"text": "음성을 텍스트로",
"speed": 1.0,
"volume": 0,
"format": "mp3",
"cache": false
}' \
--output output.mp3
# 요청 파라미터 - 사용 가능한 옵션:
curl -X POST https://fishaudio.org/api/open/v1/speech/tts \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"voiceId": "your_voice_id",
"modelId": "minimax-2.8-hd",
"text": "음성을 텍스트로",
"speed": 1.0,
"volume": 0,
"emotion": "calm",
"language": "zh",
"format": "mp3",
"cache": false
}' \
--output output.mp3
# 요청 파라미터 (undefined)온라인 디버그
상태 코드
200: Success 400: Bad Request 401: Unauthorized 403: Forbidden 404: Not Found 429: Too Many Requests 500: Internal Server Error