Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.supertoneapi.com/llms.txt

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

이 문서는 영어 원문을 기반으로 자동 번역되었습니다. 표현이 어색하거나 모호한 부분이 있을 수 있으니, 정확한 내용은 영어 원문을 함께 확인해 주세요.
2026-05-19
v1.4.0

신규 TTS 모델: supertonic_api_3

Supertone API에 supertonic_api_3가 추가되었습니다. supertonic_api_1의 차세대 후속 모델로, 이전 모델의 초저지연 특성은 그대로 유지하면서 발화 안정성을 비약적으로 개선하고 지원 언어를 확장했습니다.

주요 업데이트

  1. supertonic_api_3supertonic_api_1의 후속 모델
    • supertonic_api_1의 초저지연 특성을 그대로 계승
    • 발화 안정성이 대폭 향상되었습니다 — 발음 및 읽기 오류가 크게 감소
    • 오픈 웨이트로 공개된 Supertonic 3와는 별개로 학습된, 구분되는 모델
    • 31개 언어 지원: en, ko, ja, ar, bg, cs, da, de, el, es, et, fi, fr, hi, hr, hu, id, it, lt, lv, nl, pl, pt, ro, ru, sk, sl, sv, tr, uk, vi
    • Voice settings: speed만 지원(supertonic_api_1과 동일)
  2. supertonic_api_1은 이제 레거시 supertonic 모델입니다
    • 기존 연동을 위해 계속 사용 가능
    • 신규 프로젝트는 supertonic_api_3 사용 권장
  3. 모델 선택 옵션 확장 — TTS 요청에서 sona_speech_2, sona_speech_2_flash, supertonic_api_3, supertonic_api_1, sona_speech_1을 선택할 수 있습니다.
전체 비교와 선택 가이드는 모델을 참고해 주세요.
2025-12-08
v1.3.0

신규 TTS 모델: sona_speech_2, sona_speech_2_flash, supertonic_api_1

Supertone API에 세 개의 신규 음성 합성 모델이 추가되어 다국어 지원이 확장되었고, 더 유연한 생성 옵션을 제공합니다.

주요 업데이트

  1. sona_speech_2 — 다국어 플래그십
    • 23개 언어 지원
    • 음질과 안정성 개선
    • include_phonemesnormalized_text 지원
    • Voice settings: subharmonic_amplitude_control을 제외한 전체 파라미터 지원
  2. sona_speech_2_flash — 저지연 변형 모델
    • sona_speech_2와 동일한 23개 언어 지원
    • 더 낮은 지연시간에 최적화
    • Voice settings: pitch_shift, pitch_variance, speed, duration
  3. supertonic_api_1 (베타) — 경량·저지연 모델
    • 지원 언어: en, ko, ja, es, pt
    • 가장 빠른 추론과 가장 단순한 설정을 위해 설계
    • Voice settings: speed만 지원
  4. 모델 선택 옵션 확장 — TTS 요청에서 sona_speech_2, sona_speech_2_flash, supertonic_api_1, sona_speech_1을 선택할 수 있습니다.
전체 비교와 선택 가이드는 모델을 참고해 주세요.
2025-07-31
v1.2.0

커스텀 보이스와 스트리밍 TTS (베타)

Supertone API에 여러 신규 기능이 추가되었습니다. 이번 릴리즈에서는 Preset VoiceCustom Voice가 분리되었으며, API를 통한 보이스 클로닝이 지원됩니다. 또한 스트리밍 TTS의 베타 버전도 함께 출시되었습니다.

주요 업데이트

  1. Preset Voice와 Custom Voice 분리
    • Preset Voice: Supertone이 제작·제공하는 보이스
    • Custom Voice: 고객이 직접 등록·관리하는 클론드 보이스
    • 고객 소유 보이스 관리를 위한 /v1/custom-voices/... 신규 엔드포인트 제공
  2. API를 통한 보이스 클로닝
    • 기존에는 Supertone Play에서만 가능했던 보이스 클로닝을 API에서도 지원
    • 자세한 내용은 Create cloned voice를 참고해 주세요.
  3. 스트리밍 TTS (베타)
    • 스트리밍 TTS API의 베타 버전을 제공하며, AI 챗봇이나 캐릭터 챗과 같이 실시간성이 중요한 서비스에 적합합니다.
    • 자세한 내용은 Stream speech를 참고해 주세요.
2025-05-28
v1.1.0

Supertone API 그랜드 오픈

Supertone API가 클로즈드 베타를 마치고 정식으로 공개되었습니다. 이번 릴리즈에서는 서비스 구조와 API 사용성을 전면 개편하였으며, Play와의 통합 및 보이스 시스템의 일원화를 통해 보다 직관적이고 확장성 높은 음성 생성 플랫폼으로 발전했습니다.

주요 변경 사항

  1. Voice ID 구조 개편
    • 기존 {character-language-style} 조합에서 → **캐릭터 단위의 voice_id**로 통일
    • language, style 파라미터를 요청 본문 입력으로 분리해 유연한 호출 가능
  2. 신규 TTS 모델
    • 기존 pro, turbo 대신 → sona_speech_1 단일 모델로 통합
    • 발화 품질 개선 및 텍스트 길이 제한 상향 (200자 → 300자)
  3. 클론드 보이스 API 호출 지원
    • Play에서 생성한 클론드 보이스를 API에서도 호출 가능
    • 동일 계정 내 자동 연동, 권한 기반 보안 유지
  4. Play와 요금제 통합
    • API 사용 시 Play의 크레딧 시스템을 그대로 적용
    • 별도 요금제 없이 크레딧 공유 및 통합 결제 운영
  5. 보이스 검색 기능 강화
    • GET /voices, GET /voices/search로 필터링/탐색 가능
    • 보이스별 지원 언어, 스타일, 샘플 제공
  6. Predict Duration API 제공
    • 음성 생성 전 텍스트 길이 예측 가능 — 크레딧 차감 없음
  7. 신규 사용자 가이드와 문서 제공
    • Quickstart, Voice Selection, Error Handling, FAQ 등 실전 중심 문서 완비
    • Play ↔ API 연동 흐름을 고려한 전체 문서 리뉴얼
2025-01-23
v1.0.1

보이스 검색 기능 업데이트

원하는 보이스를 더 쉽게 찾을 수 있는 새로운 검색 기능이 추가되었습니다.

새로운 기능

  • 필터와 키워드로 보이스를 검색할 수 있는 신규 엔드포인트 추가
  • 언어, 성별, 연령, 용도별 필터링
  • 보이스 이름과 설명에서 키워드 검색
  • 대량 결과를 위한 페이지 단위 페이지네이션
자세한 내용은 Search voices를 참고해 주세요.
2024-12-23
v1.0.0

Supertone API 클로즈드 베타 출시

Supertone API 클로즈드 베타에 오신 것을 환영합니다 — 수퍼톤의 음성 AI 기술을 서비스 형태로 제공합니다.

주요 기능

  1. Text-to-speech 음성 합성 서비스
  2. 보이스 목록 조회 및 사용량 확인 API 제공

엔드포인트

시작하기

  1. console.supertoneapi.com에서 회원가입
  2. 클로즈드 베타 참여 신청
  3. 콘솔에서 API Key 발급
  4. API 연동 및 사용

콘솔 기능

  • API Key 발급 및 관리
  • 분 단위 API 사용량 모니터링
자세한 내용은 문서를 참고해 주세요.