메인 콘텐츠로 건너뛰기

Documentation Index

Fetch the complete documentation index at: https://typecast.ai/docs/llms.txt

Use this file to discover all available pages before exploring further.

​
2026년 4월
APISDK타임스탬프
타임스탬프 TTS & SDK v0.3/0.4 릴리스

​
새 엔드포인트: POST /v1/text-to-speech/with-timestamps

단일 응답으로 합성된 오디오와 단어·문자 단위 정렬 데이터를 함께 반환합니다. 자동 자막, 가라오케 하이라이트, 립싱크 애니메이션 등에 활용하기 좋습니다.
POST /v1/text-to-speech/with-timestamps
요청 스키마:
{
  "voice_id": "tc_60e5426de8b95f1d3000d7b5",
  "text": "안녕?",
  "model": "ssfm-v30"
}
응답 스키마 (요약):
{
  "audio": "<base64>",
  "audio_format": "wav",
  "audio_duration": 0.52,
  "words": [
    { "text": "안녕?", "start": 0.0, "end": 0.52 }
  ],
  "characters": [
    { "text": "안", "start": 0.0, "end": 0.2 },
    { "text": "녕", "start": 0.2, "end": 0.45 },
    { "text": "?", "start": 0.45, "end": 0.52 }
  ]
}
granularity 파라미터:granularity는 선택 파라미터이며, 생략하면 단어 단위 정렬과 문자 단위 정렬을 함께 응답합니다.
값설명
word단어 단위 정렬. 공백이 있는 언어에 권장됩니다.
char문자 단위 정렬. 일본어(jpn) 및 중국어(zho)에는 필수입니다.
캡션 분할 규칙: 문장 종결 기호(. ? ! 。 ？ ！)에서 분할하며, 큐당 7초/42자 상한선을 적용합니다(BBC/Netflix 자막 가이드라인).

​
SDK 업데이트 — 타임스탬프 TTS 전 11개 SDK에 추가

SDK버전메서드
Python0.3.0text_to_speech_with_timestamps()
JavaScript0.4.0textToSpeechWithTimestamps()
Gov0.3.0TextToSpeechWithTimestamps()
Rust0.3.0text_to_speech_with_timestamps()
Swiftv0.3.0textToSpeechWithTimestamps()
C#0.3.0TextToSpeechWithTimestampsAsync()
Java1.2.0textToSpeechWithTimestamps()
Kotlin1.2.0textToSpeechWithTimestamps()
C1.2.0typecast_text_to_speech_with_timestamps()
Zigv0.2.0textToSpeechWithTimestamps()
PHPv0.1.0textToSpeechWithTimestamps()
모든 SDK 응답 객체에는 toSrt() / toVtt() 자막 내보내기 헬퍼와 saveAudio(path) / audio_bytes() 편의 메서드가 포함되어 있습니다.
​
2026년 4월
APISDK스트리밍
스트리밍 TTS & 구독 API

​
새 엔드포인트: POST /v1/text-to-speech/stream

전체 합성을 기다리지 않고 생성되는 오디오 청크를 실시간으로 전달하는 저지연 스트리밍 엔드포인트가 추가되었습니다.
POST /v1/text-to-speech/stream
/v1/text-to-speech와의 주요 차이점:
기능표준스트리밍
응답완성된 오디오 파일청크 오디오 스트림
지연 시간전체 합성 대기첫 청크 ~200ms
volume / target_lufs지원미지원
출력 설정OutputOutputStream (피치, 템포, 포맷만)
요청 스키마:
{
  "voice_id": "tc_xxxxx",
  "text": "문의해 주셔서 감사합니다. 금요일 오후 7시로 예약이 확정되었습니다.",
  "model": "ssfm-v30",
  "language": "kor",
  "output": {
    "audio_pitch": 0,
    "audio_tempo": 1.0,
    "audio_format": "wav"
  }
}
응답: 청크 바이너리 스트림 (audio/wav 또는 audio/mpeg).

​
새 엔드포인트: GET /v1/users/me/subscription

인증된 사용자의 플랜 등급, 크레딧 사용량, 동시 요청 제한을 조회합니다.
GET /v1/users/me/subscription
응답 스키마:
{
  "plan": "lite",
  "credits": {
    "plan_credits": 100000,
    "used_credits": 157300
  },
  "limits": {
    "concurrency_limit": 5
  }
}

​
SDK 업데이트

9개 공식 SDK 모두 스트리밍 및 구독 지원이 추가되었습니다:
SDK버전스트리밍 메서드
Python0.2.0text_to_speech_stream() (동기 + 비동기)
JavaScript0.3.0textToSpeechStream() → ReadableStream
Gov0.2.0TextToSpeechStream() → io.ReadCloser
Rust0.2.0text_to_speech_stream() → Stream<Bytes>
Swiftv0.2.0textToSpeechStream() → AsyncThrowingStream
C#0.2.0TextToSpeechStreamAsync() → Stream
Java1.1.0textToSpeechStream() → InputStream
Kotlin1.1.0textToSpeechStream() → InputStream
C1.1.0typecast_text_to_speech_stream() (콜백)
​
2026년 1월
모델API캐릭터
ssfm-v30 모델 & v2 API

​
새 모델: ssfm-v30

음성 품질이 개선되고 기능이 확장된 새로운 ssfm-v30 모델 지원이 추가되었습니다.새로운 기능:
  • 스마트 이모션 - SmartPrompt를 사용한 문맥 인식 감정 추론
  • 7가지 감정 프리셋 - whisper, toneup, tonedown 프리셋 추가
  • 범용 감정 지원 - 모든 감정을 모든 캐릭터에서 사용 가능
  • 37개 언어 - 10개 새 언어 추가
새로 추가된 언어: 벵골어, 광둥어, 힌디어, 헝가리어, 민난어, 노르웨이어, 펀자브어, 태국어, 터키어, 베트남어요청 스키마 변경:
// ssfm-v30 SmartPrompt 사용 (문맥 인식 감정)
{
  "model": "ssfm-v30",
  "prompt": {
    "emotion_type": "smart",
    "previous_text": "I feel like I'm walking on air and I just want to scream with joy!",
    "next_text": "I am literally bursting with happiness and I never want this feeling to end!"
  }
}

// ssfm-v30 PresetPrompt 사용 (수동 감정 선택)
{
  "model": "ssfm-v30",
  "prompt": {
    "emotion_type": "preset",
    "emotion_preset": "happy",
    "emotion_intensity": 1.0
  }
}

​
새 엔드포인트: GET /v2/voices

모델별로 그룹화된 감정과 추가 메타데이터가 포함된 향상된 캐릭터 목록 엔드포인트가 추가되었습니다.
GET /v2/voices
쿼리 파라미터:
파라미터타입설명
modelstring모델별 필터링 (ssfm-v21, ssfm-v30)
genderstring성별별 필터링 (male, female)
agestring연령대별 필터링 (child, teenager, young_adult, middle_age, elder)
use_casesstring사용 사례별 필터링 (Audiobook, Game, E-learning 등)
응답 스키마:
[
  {
    "voice_id": "tc_xxxxx",
    "voice_name": "음성 이름",
    "models": [
      {
        "version": "ssfm-v30",
        "emotions": ["normal", "happy", "sad", "angry", "whisper", "toneup", "tonedown"]
      },
      {
        "version": "ssfm-v21",
        "emotions": ["normal", "happy", "sad"]
      }
    ],
    "gender": "female",
    "age": "young_adult",
    "use_cases": ["Audiobook", "E-learning"]
  }
]

​
지원 중단: 캐릭터 관리 엔드포인트

다음 엔드포인트가 지원 중단되어 제거되었습니다:
엔드포인트상태
POST /v1/voices제거됨
GET /v1/voices/{voice_id}제거됨
향상된 메타데이터가 포함된 캐릭터 목록을 보려면 GET /v2/voices를 사용하세요.
​
2025년 7월
모델API
초기 API 출시

​
초기 출시: ssfm-v21

ssfm-v21 모델로 타입캐스트 Text-to-Speech API를 출시했습니다.엔드포인트:
메서드엔드포인트설명
POST/v1/text-to-speech텍스트에서 음성 생성
GET/v1/voices사용 가능한 음성 목록
기능:
  • 저지연 음성 합성
  • 4가지 감정 프리셋: normal, happy, sad, angry
  • 음성에 따라 감정 사용 가능 여부가 다름
  • 27개 언어 지원
지원 언어: 영어, 한국어, 아랍어, 불가리아어, 중국어, 크로아티아어, 체코어, 덴마크어, 네덜란드어, 핀란드어, 프랑스어, 독일어, 그리스어, 인도네시아어, 이탈리아어, 일본어, 말레이어, 폴란드어, 포르투갈어, 루마니아어, 러시아어, 슬로바키아어, 스페인어, 스웨덴어, 타갈로그어, 타밀어, 우크라이나어요청 스키마:
{
  "voice_id": "tc_xxxxx",
  "text": "Everything is so incredibly perfect that I feel like I'm dreaming.",
  "model": "ssfm-v21",
  "language": "kor",
  "prompt": {
    "emotion_preset": "normal",
    "emotion_intensity": 1.0
  },
  "output": {
    "volume": 100,
    "audio_pitch": 0,
    "audio_tempo": 1.0,
    "audio_format": "wav"
  }
}