ElevenAPIVoicesSettings

编辑音色设置

编辑特定音色的设置。“similarity_boost” 对应 Web 应用中的 “Clarity + Similarity Enhancement”，“stability” 对应 Web 应用中的 “Stability” 滑块。

路径参数

voice_idstring必需

要使用的音色 ID。可使用 获取音色 端点列出所有可用音色。

请求头

xi-api-keystring可选

请求

This endpoint expects an object.
stabilitydouble or null可选0-1默认为 0.5

决定音色的稳定性以及每次生成之间的随机性。较低的值会带来更丰富的情感范围。较高的值可能使音色较为单调，情感有限。

use_speaker_boostboolean or null可选默认为 true

此设置可提高与原始说话者的相似度。使用后计算负载会略微增加，从而提高延迟。

similarity_boostdouble or null可选0-1默认为 0.75

决定 AI 在尝试复现原始音色时应遵循原始音色的程度。

styledouble or null可选默认为 0

决定音色的风格夸张程度。此设置会尝试增强原始说话者的风格。设为非 0 值时会消耗额外计算资源，并可能增加延迟。

speeddouble or null可选默认为 1

调整语速。值为 1.0 时使用默认语速；小于 1.0 会减慢语音，大于 1.0 会加快语音。

响应

成功响应

statusstring

编辑音色设置请求的状态。如果请求成功，状态将为 ‘ok’。否则将返回状态为 500 的错误消息。

错误

422
Unprocessable Entity Error