> ## 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.

# 릴리즈 노트

> Supertone API의 최신 업데이트와 변경 사항을 확인하세요.

<Note>
  이 문서는 영어 원문을 기반으로 자동 번역되었습니다. 표현이 어색하거나 모호한 부분이 있을 수 있으니, 정확한 내용은 [영어 원문](/en/docs/resources/release-notes)을 함께 확인해 주세요.
</Note>

<Update label="2026-06-16" description="CLI & MCP">
  ## 커맨드라인 인터페이스와 MCP 서버

  SDK 외에 Supertone TTS를 사용하는 두 가지 새로운 방법이 추가되었습니다: 터미널 CLI와 AI 에이전트용 MCP 서버. 둘 다 동일한 Text-to-Speech API를 감쌉니다.

  ### 주요 업데이트

  1. **Supertone CLI**
     * 문자열·파일·표준 입력으로 합성하고, 스피커로 스트리밍하고, 디렉터리 전체를 일괄 처리하고, 보이스·사용량·크레딧을 관리할 수 있습니다 — 모두 터미널에서.
     * `pip install supertone-cli`
     * [CLI](/ko/docs/developer-tools/cli)를 참고하세요.

  2. **Supertone MCP 서버**
     * TTS API를 조립 가능한 [Model Context Protocol](https://modelcontextprotocol.io) 도구로 노출해, Claude·Cursor·Claude Code·VS Code·Windsurf의 AI 에이전트가 보이스를 검색하고, 비용을 추정하고, 보이스를 복제하고, 음성을 합성할 수 있습니다.
     * `uvx supertone-mcp`
     * [MCP](/ko/docs/developer-tools/mcp)를 참고하세요.
</Update>

<Update label="2026-05-19" description="v1.4.0">
  ## 신규 TTS 모델: `supertonic_api_3`

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

  ### 주요 업데이트

  1. **`supertonic_api_3` — `supertonic_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`을 선택할 수 있습니다.

  전체 비교와 선택 가이드는 [모델](/ko/docs/core-concepts/models)을 참고해 주세요.
</Update>

<Update label="2025-12-08" description="v1.3.0">
  ## 신규 TTS 모델: `sona_speech_2`, `sona_speech_2_flash`, `supertonic_api_1`

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

  ### 주요 업데이트

  1. **`sona_speech_2` — 다국어 플래그십**
     * **23개 언어** 지원
     * 음질과 안정성 개선
     * `include_phonemes` 및 `normalized_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`을 선택할 수 있습니다.

  전체 비교와 선택 가이드는 [모델](/ko/docs/core-concepts/models)을 참고해 주세요.
</Update>

<Update label="2025-07-31" description="v1.2.0">
  ## 커스텀 보이스와 스트리밍 TTS (베타)

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

  ### 주요 업데이트

  1. **Preset Voice와 Custom Voice 분리**
     * Preset Voice: Supertone이 제작·제공하는 보이스
     * Custom Voice: 고객이 직접 등록·관리하는 클론드 보이스
     * 고객 소유 보이스 관리를 위한 `/v1/custom-voices/...` 신규 엔드포인트 제공

  2. **API를 통한 보이스 클로닝**
     * 기존에는 Supertone Play에서만 가능했던 보이스 클로닝을 API에서도 지원
     * 자세한 내용은 [Create cloned voice](/ko/api-reference/endpoints/create-cloned-voice)를 참고해 주세요.

  3. **스트리밍 TTS (베타)**
     * 스트리밍 TTS API의 베타 버전을 제공하며, AI 챗봇이나 캐릭터 챗과 같이 실시간성이 중요한 서비스에 적합합니다.
     * 자세한 내용은 [Stream speech](/ko/docs/text-to-speech/stream-speech)를 참고해 주세요.
</Update>

<Update label="2025-05-28" description="v1.1.0">
  ## Supertone API 그랜드 오픈

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

  <Frame>
    <img src="https://mintcdn.com/supertone-b89202c8/0gAKILFZFHulmmA8/images/supertone-api-grand-open.png?fit=max&auto=format&n=0gAKILFZFHulmmA8&q=85&s=1a8c108b3cc1569bd3b87aacc44fc0b1" alt="" width="2118" height="1380" data-path="images/supertone-api-grand-open.png" />
  </Frame>

  ### 주요 변경 사항

  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 연동 흐름을 고려한 전체 문서 리뉴얼
</Update>

<Update label="2025-01-23" description="v1.0.1">
  ## 보이스 검색 기능 업데이트

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

  ### 새로운 기능

  * 필터와 키워드로 보이스를 검색할 수 있는 신규 엔드포인트 추가
  * 언어, 성별, 연령, 용도별 필터링
  * 보이스 이름과 설명에서 키워드 검색
  * 대량 결과를 위한 페이지 단위 페이지네이션

  자세한 내용은 [Search voices](/ko/api-reference/endpoints/search-voices)를 참고해 주세요.
</Update>

<Update label="2024-12-23" description="v1.0.0">
  <Frame>
    <img src="https://mintcdn.com/supertone-b89202c8/0gAKILFZFHulmmA8/images/supertone-api-landing-page.png?fit=max&auto=format&n=0gAKILFZFHulmmA8&q=85&s=1e13e66b7e2d50b36c928603b7986db5" alt="" width="2880" height="2160" data-path="images/supertone-api-landing-page.png" />
  </Frame>

  ## Supertone API 클로즈드 베타 출시

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

  ### 주요 기능

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

  ### 엔드포인트

  * [List voices](/ko/api-reference/endpoints/list-voices) — 사용 가능한 보이스 목록 조회
  * [Create speech](/ko/api-reference/endpoints/text-to-speech) — 텍스트를 음성으로 변환
  * [Get voice usage](/ko/api-reference/endpoints/get-voice-usage) — API 사용량 확인

  ### 시작하기

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

  ### 콘솔 기능

  * API Key 발급 및 관리
  * 분 단위 API 사용량 모니터링

  자세한 내용은 [문서](/ko/docs/overview)를 참고해 주세요.
</Update>