Get voice

ID を指定して単一のプリセットボイスを取得します。

GET /v1/voices/{voice_id}

Get voice details by ID

cURL

curl --request GET \
  --url https://supertoneapi.com/v1/voices/{voice_id} \
  --header 'x-sup-api-key: <api-key>'

200

{
  "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"
}

このドキュメントは英語の原文から自動翻訳されています。表現に不自然な箇所がある場合があります。正確な内容は英語の原文もあわせてご確認ください。

単一のプリセットボイスについて、サポート言語、スタイル、モデル、事前生成済みサンプル URL を含む完全なボイスオブジェクトを返します。

ユーザーがクローニングしたボイスについては、代わりに カスタムボイス取得 をご利用ください。

エンドポイント

GET https://supertoneapi.com/v1/voices/{voice_id}

パスパラメータ

Name	Required	Description
voice_id	✅	プリセットボイスの ID です。

レスポンス

ボイスオブジェクトを返します。フィールドごとのリファレンスは Voices をご参照ください。

注意事項

• アカウント上に voice_id が存在しない場合は 404 Not Found を返します。
• 明示的な style パラメータなしで TTS を呼び出す前に、このエンドポイントでボイスの デフォルトスタイル（styles の最初の要素）を確認できます。

関連項目

Docs: Voices

ボイスオブジェクトの構造と voice ID の使い方。

List voices

ボイスライブラリ全体を参照します。

Authorizations

x-sup-api-key · string · header · required

Path Parameters

voice_id · string · required

Response

200

application/json

Voice details retrieved successfully

voice_id · string · required

Unique identifier for the voice

Example:

"<voice-id>"

name · string · required

Name of the voice

Example:

"Agatha"

age · string · required

Age of the voice

Example:

"young-adult"

gender · string · required

Gender of the voice

Example:

"female"

use_case · string · required

Use case of the voice

Example:

"narration"

use_cases · string[] · required

Use cases of the voice (array)

Example:

["narration", "storytelling"]

language · string[] · required

Languages supported by the voice

Example:

[
  "ar",
  "bg",
  "cs",
  "da",
  "de",
  "el",
  "en",
  "es",
  "et",
  "fi",
  "fr",
  "hi",
  "hu",
  "id",
  "it",
  "ja",
  "ko",
  "nl",
  "pl",
  "pt",
  "ro",
  "ru",
  "vi"
]

styles · string[] · required

Styles available for the voice

Example:

["kind-default", "normal", "serene"]

models · string[] · required

Models available for the voice

Example:

[
  "sona_speech_1",
  "sona_speech_2",
  "sona_speech_2_flash",
  "supertonic_api_1",
  "supertonic_api_3"
]

description · string | null

Description of the voice

Example:

""

samples · object[]

URL to the sample audio file for the voice

Show child attributes

thumbnail_image_url · string

URL to the thumbnail image for the voice

Example:

"https://example.com/thumbnails/voice-thumbnail.png"