Get disclaimer voice tuning settings

Retrieve the tuning settings used when the voice reads required disclaimers. Disclaimers often need different settings (e.g. slower speed, higher stability) than the agent’s main voice.

GET /v1/agents/{agentId}/voices/{voiceId}/disclaimer/tuning-settings

Get disclaimer voice tuning settings

cURL

curl --request GET \
  --url https://api.us.poly.ai/v1/agents/{agentId}/voices/{voiceId}/disclaimer/tuning-settings \
  --header 'x-api-key: <api-key>'

200

{
  "stability": 123,
  "similarityBoost": 123,
  "style": 123,
  "optimizeStreamingLatency": 123,
  "speed": 123,
  "modelId": "<string>"
}

Authorizations

x-api-key · string · header · required

Path Parameters

agentId · string · required

voiceId · string · required

Voice ID from the voice library

Response

200

application/json

Current disclaimer tuning settings

Voice tuning settings for a given voice and purpose. Fields are null when the tuning provider does not support them or no override has been set.

stability · integer

Voice stability (0–100). Higher values make the voice more consistent and less expressive.

similarityBoost · integer

Similarity boost (0–100). Higher values make the output sound closer to the original voice sample.

style · integer

Style exaggeration (provider-specific, 0–100)

optimizeStreamingLatency · integer

Streaming latency optimization level (provider-specific)

speed · number<float>

Playback speed multiplier. Valid range depends on the voice provider.

modelId · string

Provider model ID used for synthesis