문서로 돌아가기
FRTTS API
초저지연 TTS로 빠른 음성 응답을 구현하세요
목차
개요
FRTTS(Few-shot Real-time Text-to-Speech)는 초저지연 TTS 서비스로, 대화형 AI, 빠른 응답이 필요한 서비스, 실시간 번역 등에 최적화되어 있습니다.
초저지연
500ms 이하의 지연시간으로 빠른 응답 가능
안정성
안정적이고 일관된 품질의 음성 생성
감정 표현
다양한 감정 표현으로 생동감 있는 음성
빠른 시작
2. 기본 FRTTS 요청
cURL Example
curl -X POST "https://agitvxptajouhvoatxio.supabase.co/functions/v1/tts-synthesize-v1" \
-H "Content-Type: application/json" \
-H "X-API-Key: {YOUR_API_KEY}" \
-d '{
"text": "안녕하세요. 빠른 음성 합성 TTS입니다.",
"voiceName": "시아",
"emotion": "neutral",
"settings": {
"speed": 1.0,
"pitch": 0,
"volume": 1.0
}
}'API 엔드포인트
POST https://agitvxptajouhvoatxio.supabase.co/functions/v1/tts-synthesize-v1
필수 헤더
Content-Type: application/json
X-API-Key: {YOUR_API_KEY}요청 파라미터
| 파라미터 | 타입 | 설명 | 필수 |
|---|---|---|---|
| text | string | 변환할 텍스트 (최대 240자) | ✓ |
| voiceName | string | 음성 이름 (예: 시아, 우영 등) | ✓ |
| emotion | string | 감정 표현 (neutral, happy, sad, angry, calm) | |
| settings | object | 음성 설정 (speed, pitch, volume) |
settings 상세 설정
speed (속도)
음성 재생 속도를 조절합니다.
- • 타입: number
- • 범위: 0.5 ~ 2.0
- • 기본값: 1.0
- • 단위: 0.1
pitch (음높이)
음성의 높낮이를 조절합니다.
- • 타입: number
- • 범위: -10 ~ 10
- • 기본값: 0
- • 단위: 1
volume (볼륨)
음성의 볼륨을 조절합니다.
- • 타입: number
- • 범위: 0.0 ~ 1.0
- • 기본값: 1.0
- • 단위: 0.1
💡 사용 예시:"settings": { "speed": 1.2, "pitch": 2, "volume": 0.8 }
응답 형식
JSON Response
{
"success": true,
"job_id": "550e8400-e29b-41d4-a716-446655440000",
"audio_url": "https://download-example.output/generated.wav"
}음성 및 감정
지원 음성 (총 59개)
FRTTS는 다양한 연령, 톤, 스타일의 고품질 한국어 음성을 제공합니다. 각 음성은 서로 다른 감정 표현을 지원합니다.
감정 지원 표시:
neutral happy sad angry calm
여성 음성 (30개)
시아
자몽
주은
효은
미현
일화
향기
선주
송작가
연수
핑크캣
수민
은주
헤이제이
다인
혜진
주해란
희옥
재경
경이
순분
소리
애라
세이룬
프린세스
졸리
도금봉
자비왕후
신이
흑마녀
남성 음성 (29개)
우영
희웅
미성
선우
기림
무성
우람
준영
수주
박기자
강철
찬희
강남
또대리
행사맨
승길
허윤도
승훈
바른
달봉이
남춘
요원
레미
오과장
카이저
아라곤
폼비
개똥이
호박이
⚠️ 일부 음성은 제한된 감정만 지원합니다:
- • 도금봉: calm 미지원
- • 자비왕후: calm, sad 미지원
- • 강남: sad 미지원
- • 아라곤: sad 미지원
💡 사용법: voiceName과 emotion 파라미터를 함께 사용하세요. 예: "voiceName": "시아", "emotion": "happy"
감정 표현 상세
neutral
중립적
happy
밝고 즐거운
sad
차분하고 슬픈
angry
강렬하고 단호한
calm
차분하고 침착한
코드 예시
다양한 언어로 FRTTS API를 호출하는 예시입니다. 탭을 클릭하여 언어를 전환하세요.
TypeScript Example
const response = await fetch('https://agitvxptajouhvoatxio.supabase.co/functions/v1/tts-synthesize-v1', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'X-API-Key': '{YOUR_API_KEY}'
},
body: JSON.stringify({
text: "안녕하세요. 빠른 음성 합성 TTS입니다.",
voiceName: "시아",
emotion: "happy",
settings: {
speed: 1.0,
pitch: 0,
volume: 1.0
}
})
});
const data = await response.json();
console.log('Audio URL:', data.audio_url);