Voices

# List all available voices (returns VoiceListResponse)
result = client.voices.list()

for voice in result.voices:
    print(f"{voice.id}: {voice.name}")
    print(f"  Category: {voice.category}")
    print(f"  Languages: {', '.join(voice.supported_languages)}")
print(f"Showing {len(result.voices)} of {result.total}")

# Filter by language
result = client.voices.list(language="de")

# Paginate
page2 = client.voices.list(limit=10, offset=10)
print(f"Page 2: {len(page2.voices)} voices (total: {page2.total})")

voice = client.voices.get(voice_id=1071)
print(f"Voice: {voice.name}")
print(f"Category: {voice.category}")

voice = client.voices.create(
    name="My Custom Voice",
    sex="female",
    description="A warm, conversational voice",
    category="cloned",
    reference_files=["reference1.wav", "reference2.wav"],
)
print(f"Created voice: {voice.id}")

voice = client.voices.update(
    voice_id=1071,
    name="Updated Name",
    description="New description",
)

client.voices.delete(voice_id=1071)

# List references for a voice
refs = client.voices.list_references(voice_id=1071)
for ref in refs:
    print(f"{ref.id}: {ref.name}")

# Add a new reference (file is positional; accepts a str or Path)
ref = client.voices.add_reference(
    voice_id=1071,
    file="new_reference.wav",
    reference_text="Optional transcript of the audio.",
)

# Delete a reference
client.voices.delete_reference(voice_id=1071, reference_id=456)

voice = client.voices.publish(voice_id=1071)
print(f"Pending verification: {voice.pending_verification}")

voice = client.voices.generate_sample(voice_id=1071)
print(f"Sample URL: {voice.sample_url}")