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 custom voice를 사용해 주십시오.

엔드포인트

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

보이스 객체 구조와 보이스 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"