Skip to main content
GET
/
v1
/
voices
Gets available voices
curl --request GET \
  --url https://supertoneapi.com/v1/voices \
  --header 'x-sup-api-key: <api-key>'
{
  "items": [
    {
      "voice_id": "<voice-id>",
      "name": "Agatha",
      "age": "young-adult",
      "gender": "female",
      "use_case": "narration",
      "use_cases": [
        "narration",
        "storytelling"
      ],
      "language": [
        "ar",
        "bg",
        "cs",
        "da",
        "de",
        "el",
        "en",
        "es",
        "et",
        "fi",
        "fr",
        "hi",
        "hu",
        "id",
        "it",
        "ja",
        "ko",
        "nl",
        "pl",
        "pt",
        "ro",
        "ru",
        "vi"
      ],
      "styles": [
        "kind-default",
        "normal",
        "serene"
      ],
      "models": [
        "sona_speech_1",
        "sona_speech_2",
        "sona_speech_2_flash",
        "supertonic_api_1",
        "supertonic_api_3"
      ],
      "description": "",
      "samples": [
        {
          "language": "ko",
          "style": "kind-default",
          "model": "supertonic_api_3",
          "url": "https://example.com/samples/sample-audio.wav"
        }
      ],
      "thumbnail_image_url": "https://example.com/thumbnails/voice-thumbnail.png"
    }
  ],
  "total": 150,
  "next_page_token": "some_opaque_token_string_representing_last_id"
}
このドキュメントは英語の原文から自動翻訳されています。表現に不自然な箇所がある場合があります。正確な内容は英語の原文もあわせてご確認ください。
アカウントで利用可能なプリセットボイスライブラリを返します。これには Supertone Play のボイスライブラリと、Enterprise 顧客向けに Supertone が独自に提供しているボイスが含まれます。 ユーザーがクローニングしたボイスについては、代わりに カスタムボイス一覧 をご利用ください。

​
エンドポイント

GET https://supertoneapi.com/v1/voices

​
クエリパラメータ

NameRequiredDescription
page_size—1 ページあたりの件数です。デフォルト 20、最大 100。
next_page_token—前回のレスポンスから取得した、次ページ取得用のトークンです。

​
レスポンス

items 配列とページネーション用のオプショナルな next_page_token を返します。各アイテムは ボイスオブジェクト の形式に従い、voice_id、name、language、styles、models、samples などを含みます。

​
関連項目

Docs: Voices

ボイスオブジェクトの構造と、TTS コールでの voice ID の使い方。

Search voices

言語、スタイル、性別などで絞り込みます。

Authorizations

​
x-sup-api-key
string
header
required

Query Parameters

​
page_size
number

Number of items per page (default: 20, min: 10, max: 100)

​
next_page_token
string

Token for pagination (obtained from the previous page's response)

Response

Paginated available voices response with next page token

​
items
object[]
required

List of character items

​
total
number
required

Total number of available characters (might be approximate or removed in future)

Example:

150

​
next_page_token
string

Token for fetching the next page of results. Undefined if no more pages.

Example:

"some_opaque_token_string_representing_last_id"