Manage Voices

List, inspect, update, and delete your voice models

Every voice you clone becomes a model you own. List your library, look up a model’s details, rename or re-share it, and delete what you no longer need — all from the API directly, the Python library, or JavaScript.

Use it in the web app

No code — manage voices in the browser.

API reference

Every endpoint for voice models.

Cookbooks

Search and reuse Library voices.

When to use it

Browse your library

List the voices you’ve created or saved.

Find a voice id

Look up the reference_id to use in Text to Speech.

Update metadata

Rename, re-tag, or change a model’s visibility.

Clean up

Delete models you no longer use.

List your voices

Page through your library. The response carries the total count and the items for the current page.

Python

from fishaudio import FishAudio

client = FishAudio()  # reads FISH_API_KEY

page = client.voices.list(self_only=True, page_size=20)

print(f"{page.total} voices")
for v in page.items:
    print(v.id, v.title, v.state, v.visibility)

Get, update, and delete

Use a voice id to inspect a single model, change its metadata, or remove it.

Python

# Inspect one model
voice = client.voices.get("YOUR_VOICE_ID")
print(voice.title, voice.state)

# Update metadata (only the fields you pass change)
client.voices.update(
    "YOUR_VOICE_ID",
    title="Updated title",
    visibility="unlist",
)

# Delete
client.voices.delete("YOUR_VOICE_ID")

Implementation details

Filtering and pagination

Narrow the list with title, tags, or language, and page with page_size and page_number. Omit self_only (API: self) to search the public Voice Library instead of just your own models.

Python

page = client.voices.list(
    self_only=True,
    title="narration",
    page_size=50,
    page_number=2,
)

Visibility

Switch a model between private, unlist (shareable link), and public (listed in the Voice Library) with update. Publishing a model lets anyone use it as a reference_id.

Going further

Clone a voice

Create a new model from audio samples.

Speak with a voice

Use any voice id as reference_id.

Voice Models API

Every endpoint for listing and managing models.

Python reference

The full voices resource surface.