FRTTS API

초저지연 TTS로 빠른 음성 응답을 구현하세요

개요

FRTTS(Few-shot Real-time Text-to-Speech)는 초저지연 TTS 서비스로, 대화형 AI, 빠른 응답이 필요한 서비스, 실시간 번역 등에 최적화되어 있습니다.

초저지연

500ms 이하의 지연시간으로 빠른 응답 가능

안정성

안정적이고 일관된 품질의 음성 생성

감정 표현

다양한 감정 표현으로 생동감 있는 음성

API 엔드포인트

POST https://agitvxptajouhvoatxio.supabase.co/functions/v1/tts-synthesize-v1

필수 헤더

Content-Type: application/json
X-API-Key: {YOUR_API_KEY}

요청 파라미터

파라미터타입설명필수
textstring변환할 텍스트 (최대 240자)
voiceNamestring음성 이름 (예: 시아, 우영 등)
emotionstring감정 표현 (neutral, happy, sad, angry, calm)
settingsobject음성 설정 (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"
}
음성 및 감정

지원 음성

FRTTS는 다양한 연령, 톤, 스타일의 고품질 한국어 음성을 제공합니다. 각 음성은 서로 다른 감정 표현을 지원합니다.

감정 지원 표시:

neutral happy sad angry calm
여성 음성
시아
자몽
주은
효은
미현
일화
향기
선주
송작가
연수
핑크캣
수민
헤이제이
다인
혜진
주해란
희옥
재경
경이
순분
소리
애라
세이룬
프린세스
졸리
도금봉
자비왕후
신이
흑마녀
남성 음성
우영
희웅
미성
선우
기림
무성
우람
준영
수주
박기자
강철
찬희
강남
또대리
행사맨
승길
허윤도
승훈
바른
달봉이
남춘
요원
레미
오과장
카이저
아라곤
폼비
개똥이
호박이

⚠️ 일부 음성은 제한된 감정만 지원합니다:

  • 도금봉: 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);