GET
/
v1
/
voices
Gets available voices
curl --request GET \
  --url https://supertoneapi.com/v1/voices \
  --header 'x-sup-api-key: <x-sup-api-key>'
{
  "items": [
    {
      "voice_id": "<voice-id>",
      "name": "Agatha",
      "description": "",
      "age": "young-adult",
      "gender": "female",
      "use_case": "narration",
      "use_cases": [
        "narration",
        "storytelling"
      ],
      "language": [
        "ko",
        "en",
        "ja"
      ],
      "styles": [
        "kind-default",
        "normal",
        "serene"
      ],
      "models": [
        "sona_speech_1"
      ],
      "samples": [
        {
          "language": "ko",
          "style": "kind-default",
          "model": "sona_speech_1",
          "url": "https://example.com/samples/sample-audio.wav"
        }
      ],
      "thumbnail_image_url": "https://example.com/thumbnails/voice-thumbnail.png"
    }
  ],
  "total": 150,
  "nextPageToken": "some_opaque_token_string_representing_last_id"
}
このリストには、Supertone Playボイスライブラリに含まれるボイスだけでなく、Supertoneがエンタープライズ顧客専用に提供するカスタムデザインボイスも含まれます。

Headers

x-sup-api-key
string
required

API key for the service

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

The response is of type object.