List the available WellSaid voice avatars. Returns each voice's speaker_id (the value you pass to wellsaid_generate_speech) plus name, style, accent, gender, and language when the API provides them. Optionally filter with a case-insensitive substring search.

Summarize the distinct styles, accents, genders, languages, and characteristics across all voices — useful for narrowing a wellsaid_list_voices search.

Convert text to speech with a WellSaid voice and save it to disk. Synchronous. Text is limited to 1000 characters (any AI Director markup counts). Optional prosody (pitch/tempo/loudness) wraps the text in AI Director tags and uses the 'caruso' model — when you pass these, the text is treated as literal (special characters escaped), so don't also hand-author inline tags in the same call. For hand-authored inline tags (e.g. ), leave pitch/tempo/loudness unset. Get a speaker_id from wellsaid_list_voices first.

Render text to speech and also get word-level timing and caption files. The API returns a zip (audio + JSON timing + SRT + VTT); this tool extracts and saves each file. Supports the same voice/model/prosody options as wellsaid_generate_speech.

Start an asynchronous TTS render and return the clip id/status. Use for long or batched jobs, then poll with wellsaid_get_clip. Returns the raw job record from the API.

Fetch the status/metadata of a clip by id. If download is true and the clip is ready, save its audio to disk (when the API returns a URL or audio payload).

List recent clips created on the account (id, status, metadata).

Merge multiple existing clips into a single audio file with optional pauses. Provide clip ids in order. pause_durations is a single number applied between all clips, or an array of length (clip_ids.length - 1) for per-gap control.

Get WellSaid respelling suggestions for a word. Use the returned value in an inline AI Director tag, e.g. pizza, to control pronunciation.

Escape hatch for endpoints without a dedicated tool (e.g. replacement libraries). Makes an authenticated request to any path under the API base. JSON responses return as text; binary responses are saved to disk when save_as is provided.