> ## Documentation Index
> Fetch the complete documentation index at: https://supertone-b89202c8.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 릴리즈 노트

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

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

**2026-06-16**

## 커맨드라인 인터페이스와 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)를 참고하세요.

**2026-05-19**

## 신규 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)을 참고해 주세요.

**2025-12-08**

## 신규 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)을 참고해 주세요.

**2025-07-31**

## 커스텀 보이스와 스트리밍 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)를 참고해 주세요.

**2025-05-28**

## Supertone API 그랜드 오픈

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

![](https://mintcdn.com/supertone-b89202c8/0gAKILFZFHulmmA8/images/supertone-api-grand-open.png?fit=max\&auto=format\&n=0gAKILFZFHulmmA8\&q=85\&s=1a8c108b3cc1569bd3b87aacc44fc0b1)

### 주요 변경 사항

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**

## 보이스 검색 기능 업데이트

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

### 새로운 기능

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

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

**2024-12-23**

![](https://mintcdn.com/supertone-b89202c8/0gAKILFZFHulmmA8/images/supertone-api-landing-page.png?fit=max\&auto=format\&n=0gAKILFZFHulmmA8\&q=85\&s=1e13e66b7e2d50b36c928603b7986db5)

## 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)를 참고해 주세요.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.