Update Voice Config
Voices
Update Voice Config
Update default synthesis settings on a voice you own.
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) andexpressiveness(0.0-1.0 float). - BTTS V2 / V3 voices accept
consistency(1-32 integer, lower is more consistent) andboost(0 or 1).
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".Docs for agents: llms.txt