音声合成で最も重要な要素は、どの声でテキストを読むかを決定するボイスIDです。この文書では、希望するボイスを見つける方法と、API呼び出しに必要なボイス情報をどのように確認できるかをご案内します。

​
1. ボイスIDとは何ですか？

voice_idは、一つのユニークなキャラクターを識別する値です。 音声を合成する際は、このボイスIDに加えて、言語（language）、スタイル（style）、**モデル（model）**情報を一緒に渡す必要があり、正確な音声が生成されます。

​
2. ボイスIDを見つける3つの方法

​
2.1 Supertone Playからコピーする

最も早く直感的な方法は、Supertone Playのボイスライブラリからvoice_idをコピーすることです。
  • 各ボイス項目内のCopy voice IDボタンをクリックすると
  • そのボイスのIDがクリップボードにコピーされます
  • クローンボイスも別のタブで確認できます
Supertone Playへ移動 基本ボイス例：
クローンボイス例：

​
2.2 GET /v1/voicesで全ボイスリストを取得

APIを通じて条件なしに使用可能な全ボイスリストを確認するには、GET /voicesエンドポイントを使用してください。 
GET /v1/voices
レスポンスには以下の情報が含まれます：
  • voice_id：呼び出しで使用されるID
  • name：キャラクター名（例：Agatha、Adamなど）
  • language：サポートする言語リスト
  • styles：選択可能なスタイルリスト
  • models：使用可能な音声モデル
  • samples：言語/スタイル/モデル別サンプル音声
  • thumbnail_image_url：ボイス画像
レスポンス例： 
{
    "voice_id": "91992bbd4758bdcf9c9b01",
    "name": "Adam",
    "description": "",
    "age": "young-adult",
    "gender": "male",
    "use_case": "meme",
    "language": [
       "ko",
       "en",
       "ja"
       ],
     "styles": [
       "neutral"
       ],
     "models": [
       "sona_speech_1"
       ],
     "samples": [
       {
        "language": "ja",
        "style": "neutral",
        "model": "sona_speech_1",
        "url": "https://d2hxfz33hpdvze.cloudfront.net/voice-library/resources/20250502_044710.wAA5PFQe7BHNQjrfMiNrRd.speech.wav"
        },
       {
        "language": "ko",
        "style": "neutral",
        "model": "sona_speech_1",
        "url": "https://d2hxfz33hpdvze.cloudfront.net/voice-library/resources/20250502_044844.tehBuHoUhZcWsCfUsr15As.speech.wav"
        },
        {
         "language": "en",
         "style": "neutral",
         "model": "sona_speech_1",
         "url": "https://d2hxfz33hpdvze.cloudfront.net/voice-library/resources/20250201_132654.rdMFfzDsaub9qXABwti65M.speech.wav"
         }
         ],
         "thumbnail_image_url": "https://d2hxfz33hpdvze.cloudfront.net/voice-library/resources/7wmvg5vEBeooDEB9xnut6s.png"
}

​
2.3 GET /v1/voices/searchで条件別フィルタリング

特定の言語やスタイル、用途に合うボイスのみを探したい場合は、GET /voices/searchエンドポイントを使用してみてください。 
GET /v1/voices/search?language=ko&style=happy
サポートフィルター：
  • language：言語コード（ko、en、jaなど）
  • style：感情スタイル（neutral、happyなど）
  • name、description、gender、age、use_caseなども検索可能
ソート機能はサポートされておらず、正確な条件指定が重要です。

​
📌 クローンボイスを探したい場合は？

name=My Voiceで検索すると、現在のアカウントで作成したクローンボイスをすべて確認できます。 
GET /v1/voices/search?name=My Voice
上記検索によるレスポンス例は以下の通りです。 
{
    "items": [
        {
            "voice_id": "opSGuRvHBe7EfZ4LQga1hE",
            "name": "My Voice 1",
            "description": "",
            "age": "",
            "gender": "",
            "use_case": "",
            "language": [
                "ja"
            ],
            "styles": [
                "jealous"
            ],
            "models": [
                "sona_speech_1"
            ],
            "samples": [
                {
                    "language": "ja",
                    "style": "jealous",
                    "model": "sona_speech_1",
                    "url": "https://d2hxfz33hpdvze.cloudfront.net/voice-library/resources/20250514_160801.bDwEhmuq8JALRMP3nSHzUD.speech.wav"
                }
            ],
            "thumbnail_image_url": ""
        },
        {
            "voice_id": "hZGrJcUTNSNwfZDzasAVUh",
            "name": "My Voice 2",
            "description": "",
            "age": "",
            "gender": "",
            "use_case": "",
            "language": [
                "en"
            ],
            "styles": [
                "active"
            ],
            "models": [
                "sona_speech_1"
            ],
            "samples": [
                {
                    "language": "en",
                    "style": "active",
                    "model": "sona_speech_1",
                    "url": "https://d2hxfz33hpdvze.cloudfront.net/voice-library/resources/20250514_161008.ekky3mQgtgVLWLa54ispy5.speech.wav"
                }
            ],
            "thumbnail_image_url": ""
        }
    ],
    "total": 2,
    "next_page_token": null
}

​
3. サンプルオーディオとスタイル情報の確認

ボイスオブジェクトのsamplesフィールドには、言語（language）、スタイル（style）、モデル（model）の組み合わせによるサンプルオーディオが含まれています。 
{
  "language": "ko",
  "style": "neutral",
  "model": "sona_speech_1",
  "url": "https://.../speech.wav"
}
このURLにアクセスすると、実際の発話サンプルをダウンロードできます。キャラクターによってサポートするスタイル/言語/モデルの組み合わせが異なるため、使用前に必ず確認してください。

​
4. 次のステップ

ボイスIDを見つけたら、Text-to-Speech ガイドを参考にして、テキスト入力、パラメータ設定、オーディオ出力形式を指定して呼び出しを続けてみてください。