Skip to main content
PATCH
Update Voice Config

Overview

Updates the default consistency and expressiveness settings on a voice clone. These defaults are applied when Speak is called without per-request overrides. Equivalent to Update Voice Settings (POST /v1/voices/{id}/settings). Both share the same write path; POST /settings is the canonical form and returns a lighter response envelope. This PATCH /config route is kept for backwards compatibility. The accepted parameters depend on the voice’s engine:
  • BTTS V1 voices accept consistency (0.0-1.0 float) and expressiveness (0.0-1.0 float).
  • BTTS V2 / V3 voices accept consistency (1-32 integer, lower is more consistent) and boost (0 or 1).
Only voices owned by your org can be configured.

Headers

string
required
Your API key for authentication.

Path Parameters

string
required
UUID of the voice to configure.

Body Parameters

number
Default consistency for this voice. Float 0.0-1.0 for V1 voices; integer 1-32 for V2/V3 voices (lower is more consistent).
number
Default expressiveness for V1 voices only. Float 0.0-1.0.
integer
Expressiveness boost for V2 and V3 voices only. 0 or 1.

Response

Returns the full updated voice.
string
success on success.
string
Human-readable confirmation, for example "Voice configuration updated successfully".
object
The updated voice. See Get Voice for the full field list.

Docs for agents: llms.txt