> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jiekou.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Elevenlabs TTS v3 时间戳语音生成

将文本转换为语音，并返回 Base64 音频和字符级时间戳信息。

## 请求头

<ParamField header="Content-Type" type="string" required={true}>
  枚举值: `application/json`
</ParamField>

<ParamField header="Authorization" type="string" required={true}>
  Bearer 身份验证格式: Bearer \{\{API 密钥}}。
</ParamField>

## 请求体

<ParamField body="seed" type="integer" nullable={true}>
  可选的确定性生成种子，但不保证完全确定。

  取值范围：\[0, 4294967295]
</ParamField>

<ParamField body="text" type="string" required={true}>
  需要转换为语音的文本。

  长度限制：1 - 无限制
</ParamField>

<ParamField body="voice_id" type="string" required={true}>
  用于语音生成的音色 ID。
</ParamField>

<ParamField body="language_code" type="string" nullable={true}>
  输入文本的语言代码，模型支持显式语言选择时使用。
</ParamField>

<ParamField body="output_format" type="string" default="mp3_44100_128">
  生成音频的输出格式，格式为 codec\_sample\_rate\_bitrate，例如 mp3\_22050\_32。部分格式可能需要账号等级支持。

  可选值：`alaw_8000`, `mp3_22050_32`, `mp3_24000_48`, `mp3_44100_128`, `mp3_44100_192`, `mp3_44100_32`, `mp3_44100_64`, `mp3_44100_96`, `opus_48000_128`, `opus_48000_192`, `opus_48000_32`, `opus_48000_64`, `opus_48000_96`, `pcm_16000`, `pcm_22050`, `pcm_24000`, `pcm_32000`, `pcm_44100`, `pcm_48000`, `pcm_8000`, `ulaw_8000`, `wav_16000`, `wav_22050`, `wav_24000`, `wav_32000`, `wav_44100`, `wav_48000`, `wav_8000`
</ParamField>

<ParamField body="voice_settings" type="object" nullable={true}>
  语音生成设置。留空时使用所选音色的默认配置。

  <Expandable title="properties" defaultOpen={true}>
    <ParamField body="speed" type="number">
      控制生成语音的语速。

      取值范围：\[0.7, 1.2]
    </ParamField>

    <ParamField body="style" type="number">
      控制支持该能力时的语音风格夸张程度。

      取值范围：\[0, 1]
    </ParamField>

    <ParamField body="stability" type="number">
      控制语音稳定性，值越高输出越一致。

      取值范围：\[0, 1]
    </ParamField>

    <ParamField body="similarity_boost" type="number">
      控制生成语音与所选音色的相似度。

      取值范围：\[0, 1]
    </ParamField>

    <ParamField body="use_speaker_boost" type="boolean">
      支持该能力时增强与说话人的相似度。
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="next_request_ids" type="array" nullable={true}>
  用于改善连续性的后续请求 ID，最多 3 个。

  数组长度：0 - 3
</ParamField>

<ParamField body="previous_request_ids" type="array" nullable={true}>
  用于改善连续性的历史请求 ID，最多 3 个。

  数组长度：0 - 3
</ParamField>

<ParamField body="apply_text_normalization" type="string" default="auto">
  文本规范化模式。

  可选值：`auto`, `on`, `off`
</ParamField>

<ParamField body="apply_language_text_normalization" type="boolean" default={false}>
  是否应用特定语言的文本规范化。
</ParamField>

<ParamField body="pronunciation_dictionary_locators" type="array" nullable={true}>
  要应用的发音词典，最多 3 个。

  数组长度：0 - 3

  <Expandable title="properties" defaultOpen={true}>
    <ParamField body="version_id" type="string" required={true}>
      发音词典版本 ID。
    </ParamField>

    <ParamField body="pronunciation_dictionary_id" type="string" required={true}>
      发音词典 ID。
    </ParamField>
  </Expandable>
</ParamField>

## 响应信息

<ResponseField name="alignment" type="object" required={false}>
  原始文本的字符级时间戳信息。

  <Expandable title="properties" defaultOpen={true}>
    <ResponseField name="characters" type="array" required={false}>
      文本中的字符。
    </ResponseField>

    <ResponseField name="character_end_times_seconds" type="array" required={false}>
      每个字符的结束时间，单位为秒。
    </ResponseField>

    <ResponseField name="character_start_times_seconds" type="array" required={false}>
      每个字符的开始时间，单位为秒。
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="audio_base64" type="string" required={false}>
  Base64 编码的生成音频。
</ResponseField>

<ResponseField name="normalized_alignment" type="object" required={false}>
  规范化文本的字符级时间戳信息。

  <Expandable title="properties" defaultOpen={true}>
    <ResponseField name="characters" type="array" required={false}>
      文本中的字符。
    </ResponseField>

    <ResponseField name="character_end_times_seconds" type="array" required={false}>
      每个字符的结束时间，单位为秒。
    </ResponseField>

    <ResponseField name="character_start_times_seconds" type="array" required={false}>
      每个字符的开始时间，单位为秒。
    </ResponseField>
  </Expandable>
</ResponseField>