Get Voice

Retrieve metadata about a specific voice

Overview

The voices.get() method returns metadata about a specific voice, including its name, category, labels, samples, and other configuration details.

Method Signature

client.voices.get(
    voice_id: str,
    with_settings: Optional[bool] = None,
    request_options: Optional[RequestOptions] = None
) -> Voice

Parameters

Returns

Voice · object

Voice object containing detailed metadata about the voice.

Show Voice Fields

voice_id · str · required

The ID of the voice.

name · str

The name of the voice.

category · str

The category of the voice. Possible values:

• premade - Pre-made voice
• cloned - Cloned voice
• generated - Generated voice
• professional - Professional voice

description · str

The description of the voice.

labels · Dict[str, str]

Labels associated with the voice. Common keys include:

• language - The language of the voice
• accent - The accent type
• gender - The gender of the voice
• age - The age range

preview_url · str

The preview URL of the voice audio sample.

samples · List[VoiceSample]

List of audio samples associated with the voice. Each sample includes:

• sample_id - Unique identifier for the sample
• file_name - Original filename
• mime_type - MIME type of the audio
• size_bytes - Size in bytes
• hash - Hash of the sample

settings · VoiceSettings

The current settings for the voice, including:

• stability - Voice stability (0.0 to 1.0)
• similarity_boost - Similarity enhancement (0.0 to 1.0)
• style - Style exaggeration (0.0 to 1.0)
• speed - Speech speed multiplier
• use_speaker_boost - Whether speaker boost is enabled

fine_tuning · FineTuningResponse

Fine-tuning information for professional voice clones.

sharing · VoiceSharingResponse

Information about voice sharing settings.

high_quality_base_model_ids · List[str]

The base model IDs for high-quality voices.

verified_languages · List[VerifiedVoiceLanguageResponseModel]

The verified languages for the voice.

collection_ids · List[str]

The IDs of collections this voice belongs to.

safety_control · str

The safety controls applied to the voice.

voice_verification · VoiceVerificationResponse

Voice verification status and details.

permission_on_resource · str

The permission level on this voice resource.

is_owner · bool

Whether the current user is the owner of the voice.

is_legacy · bool

Whether the voice is a legacy voice.

is_mixed · bool

Whether the voice is a mixed voice.

favorited_at_unix · int

Timestamp when the voice was marked as favorite (Unix time).

created_at_unix · int

The creation time of the voice (Unix time).

is_bookmarked · bool

Whether the voice is bookmarked by the current user. Only relevant for community (library-copied) voices.

available_for_tiers · List[str]

The subscription tiers the voice is available for.

Examples

Basic Usage

Retrieve metadata for a specific voice:

from elevenlabs import ElevenLabs

client = ElevenLabs(api_key="YOUR_API_KEY")

voice = client.voices.get(voice_id="21m00Tcm4TlvDq8ikWAM")

print(f"Voice: {voice.name}")
print(f"Category: {voice.category}")
print(f"Description: {voice.description}")

Access Voice Labels

Retrieve and display voice labels:

from elevenlabs import ElevenLabs

client = ElevenLabs(api_key="YOUR_API_KEY")

voice = client.voices.get(voice_id="21m00Tcm4TlvDq8ikWAM")

if voice.labels:
    print("Voice Labels:")
    for key, value in voice.labels.items():
        print(f"  {key}: {value}")

Check Voice Settings

Inspect the current settings for a voice:

from elevenlabs import ElevenLabs

client = ElevenLabs(api_key="YOUR_API_KEY")

voice = client.voices.get(voice_id="21m00Tcm4TlvDq8ikWAM")

if voice.settings:
    print("Voice Settings:")
    print(f"  Stability: {voice.settings.stability}")
    print(f"  Similarity Boost: {voice.settings.similarity_boost}")
    print(f"  Style: {voice.settings.style}")
    print(f"  Speed: {voice.settings.speed}")
    print(f"  Speaker Boost: {voice.settings.use_speaker_boost}")

List Voice Samples

Retrieve information about voice samples:

from elevenlabs import ElevenLabs

client = ElevenLabs(api_key="YOUR_API_KEY")

voice = client.voices.get(voice_id="21m00Tcm4TlvDq8ikWAM")

if voice.samples:
    print(f"Voice has {len(voice.samples)} samples:")
    for sample in voice.samples:
        print(f"  - {sample.file_name} ({sample.size_bytes} bytes)")

Check Ownership

Verify if you own a voice:

from elevenlabs import ElevenLabs

client = ElevenLabs(api_key="YOUR_API_KEY")

voice = client.voices.get(voice_id="21m00Tcm4TlvDq8ikWAM")

if voice.is_owner:
    print(f"You own the voice: {voice.name}")
else:
    print(f"This is a shared or default voice: {voice.name}")

Async Usage

Retrieve voice metadata asynchronously:

import asyncio
from elevenlabs import AsyncElevenLabs

client = AsyncElevenLabs(api_key="YOUR_API_KEY")

async def main():
    voice = await client.voices.get(voice_id="21m00Tcm4TlvDq8ikWAM")
    print(f"Voice: {voice.name}")
    print(f"Category: {voice.category}")

asyncio.run(main())

Related Methods

• Search Voices - List and filter available voices
• Clone Voice - Create an instant voice clone
• Voice Settings - Manage voice settings