> ## 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を使う2つの新しい方法が追加されました：ターミナルCLIと、AIエージェント向けのMCPサーバー。どちらも同じText-to-Speech APIをラップしています。

  ### 主なアップデート

  1. **Supertone CLI**
     * 文字列・ファイル・標準入力から合成し、スピーカーへストリーミングし、ディレクトリ全体を一括処理し、ボイス・使用量・クレジットを管理できます — すべてターミナルから。
     * `pip install supertone-cli`
     * [CLI](/ja/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](/ja/docs/developer-tools/mcp)を参照してください。
</Update>

<Update label="2026-05-19" description="v1.4.0">
  ## 新規TTSモデル：`supertonic_api_3`

  Supertone APIで、`supertonic_api_1`の次世代後継モデルである`supertonic_api_3`がサポートされるようになりました。前モデルの超低レイテンシ特性を維持しつつ、発話安定性が大幅に向上し、対応言語も拡張されています。

  ### 主なアップデート

  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`が利用可能になりました。

  比較と選択のガイダンスの全体は[モデル](/ja/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に3つの新しい音声合成モデルが追加され、多言語対応の拡張とより柔軟な生成オプションを提供します。

  ### 主なアップデート

  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`（beta） — 軽量・低レイテンシモデル**
     * 対応言語：`en`、`ko`、`ja`、`es`、`pt`
     * 最速の推論とシンプルなセットアップを実現する設計
     * voice settings：`speed`のみ

  4. **モデル選択の拡張** — TTSリクエストで`sona_speech_2`、`sona_speech_2_flash`、`supertonic_api_1`、`sona_speech_1`が利用可能になりました。

  比較と選択のガイダンスの全体は[モデル](/ja/docs/core-concepts/models)を参照してください。
</Update>

<Update label="2025-07-31" description="v1.2.0">
  ## カスタムボイスとストリーミングTTS（ベータ）

  Supertone APIに複数の新機能が追加されました。今回のリリースでは**プリセットボイス**と**カスタムボイス**が分離され、APIを通じたボイスクローンの登録が可能になりました。また、ストリーミングTTSのベータ版も公開されました。

  ### 主なアップデート

  1. **プリセットボイスとカスタムボイスの分離**
     * プリセットボイスはSupertoneが設計・提供するボイスです。
     * カスタムボイスはお客様が登録・管理するクローンボイスです。
     * お客様所有のボイスを管理する新しいエンドポイント群（`/v1/custom-voices/...`配下）。

  2. **APIによるボイスクローン**
     * これまでSupertone Playでのみ可能だったボイスクローンが、APIでもサポートされるようになりました。
     * 詳しくは[Create cloned voice](/ja/api-reference/endpoints/create-cloned-voice)をご覧ください。

  3. **ストリーミングTTS（ベータ）**
     * AIチャットボットやキャラクターチャットなど、リアルタイム性が重要なアプリケーションに最適なストリーミングTTS APIのベータ版を公開しました。
     * 詳しくは[Stream speech](/ja/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](/ja/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**クローズドベータへようこそ — Supertoneの音声AI技術をサービスとして提供します。

  ### 主な機能

  1. Text-to-speech音声合成サービス。
  2. ボイス一覧の照会および使用量確認API。

  ### エンドポイント

  * [List voices](/ja/api-reference/endpoints/list-voices) — 利用可能なボイスを取得。
  * [Create speech](/ja/api-reference/endpoints/text-to-speech) — テキストを音声に変換。
  * [Get voice usage](/ja/api-reference/endpoints/get-voice-usage) — API使用量を確認。

  ### 開始方法

  1. [console.supertoneapi.com](https://console.supertoneapi.com)でサインアップ。
  2. クローズドベータへの参加を申請。
  3. コンソールからAPI Keyを発行。
  4. APIを連携して使用。

  ### コンソール機能

  * API Keyの発行と管理。
  * 分単位のAPI使用量モニタリング。

  詳しくは[ドキュメント](/ja/docs/overview)を参照してください。
</Update>
