Skip to main content
Manage your custom voice clones using the Gradium SDK.

​
List All Custom Voices

Retrieve all custom voices for your organization. 
import json
import gradium

client = gradium.client.GradiumClient()

all_custom_voices = await gradium.voices.get(client)
print(json.dumps(all_custom_voices, indent=2))

​
Get a Specific Voice

Retrieve details for a single voice by its UID. 
import json
import gradium

client = gradium.client.GradiumClient()

voice = await gradium.voices.get(client, voice_uid="abc123def456")
print(json.dumps(voice, indent=2))

​
Update a Voice

Update the metadata of an existing voice. The PUT /voices/{uid} endpoint accepts name, description, language, start_s, tags, and rank. The SDK helper exposes a subset; for language, tags, or rank call the REST endpoint directly. 
import gradium

client = gradium.client.GradiumClient()

await gradium.voices.update(
    client,
    voice_uid="abc123def456",
    name="Updated Voice Name",
    description="Updated description",
    start_s=1.5
)

​
Delete a Voice

Permanently delete a custom voice. 
import gradium

client = gradium.client.GradiumClient()

await gradium.voices.delete(client, voice_uid="abc123def456")