> ## 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.

# Síntesis de voz síncrona MiniMax Speech 2.8 Turbo

Convierte texto en voz, con soporte para múltiples voces, control de emociones, ajuste de velocidad de habla y otras funciones. La longitud del texto debe ser inferior a 10000 caracteres. Si la longitud del texto supera los 3000 caracteres, se recomienda usar salida en streaming.

## Encabezados de solicitud

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

<ParamField header="Authorization" type="string" required={true}>
  Formato de autenticación Bearer: Bearer \{\{API Key}}.
</ParamField>

## Cuerpo de la solicitud

<ParamField body="text" type="string" required={true}>
  Texto que se debe sintetizar en voz. La longitud debe ser inferior a 10000 caracteres. Si la longitud del texto supera los 3000 caracteres, se recomienda usar salida en streaming. Admite cambios de párrafo (saltos de línea), control de pausas (marcador `&lt;#x#&gt;`) y etiquetas de muletillas/expresiones vocales (como (laughs), (coughs), etc.; solo compatibles con speech-2.8-hd/turbo)
</ParamField>

<ParamField body="stream" type="boolean" default={false}>
  Controla si se usa salida en streaming. El valor predeterminado es false, es decir, el streaming no está habilitado
</ParamField>

<ParamField body="voice_modify" type="object">
  <Expandable title="propiedades" defaultOpen={true}>
    <ParamField body="pitch" type="integer">
      Ajuste de tono (grave/brillante), rango \[-100, 100]. Cuanto más cerca esté el valor de -100, más grave será la voz; cuanto más cerca esté de 100, más brillante será

      Rango de valores: \[-100, 100]
    </ParamField>

    <ParamField body="timbre" type="integer">
      Ajuste de timbre (magnético/cristalino), rango \[-100, 100]. Cuanto más cerca esté el valor de -100, más densa será la voz; cuanto más cerca esté de 100, más cristalina será

      Rango de valores: \[-100, 100]
    </ParamField>

    <ParamField body="intensity" type="integer">
      Ajuste de intensidad (potente/suave), rango \[-100, 100]. Cuanto más cerca esté el valor de -100, más enérgica será la voz; cuanto más cerca esté de 100, más suave será

      Rango de valores: \[-100, 100]
    </ParamField>

    <ParamField body="sound_effects" type="string">
      Configuración de efectos de sonido. Solo se puede seleccionar uno por vez. Valores disponibles: spacious\_echo (eco en espacio abierto), auditorium\_echo (megafonía de auditorio), lofi\_telephone (distorsión telefónica), robotic (sonido electrónico)

      Valores permitidos: `spacious_echo`, `auditorium_echo`, `lofi_telephone`, `robotic`
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="audio_setting" type="object">
  <Expandable title="propiedades" defaultOpen={true}>
    <ParamField body="format" type="string" default="mp3">
      Formato del audio generado. wav solo es compatible con salida no streaming

      Valores permitidos: `mp3`, `pcm`, `flac`, `wav`
    </ParamField>

    <ParamField body="bitrate" type="integer" default={128000}>
      Tasa de bits del audio generado. Rango disponible \[32000, 64000, 128000, 256000], valor predeterminado 128000. Este parámetro solo tiene efecto para audio en formato mp3

      Valores permitidos: `32000`, `64000`, `128000`, `256000`
    </ParamField>

    <ParamField body="channel" type="integer" default={1}>
      Número de canales del audio generado. Rango disponible: \[1, 2], donde 1 es mono y 2 es estéreo. El valor predeterminado es 1

      Valores permitidos: `1`, `2`
    </ParamField>

    <ParamField body="force_cbr" type="boolean" default={false}>
      Control de tasa de bits constante (cbr) para el audio. Valores disponibles: false, true. Cuando este parámetro se establece en true, el audio se codifica con tasa de bits constante. Nota: este parámetro solo tiene efecto cuando el audio está configurado como salida en streaming y el formato de audio es mp3
    </ParamField>

    <ParamField body="sample_rate" type="integer" default={32000}>
      Frecuencia de muestreo del audio generado. Rango disponible \[8000, 16000, 22050, 24000, 32000, 44100], valor predeterminado 32000

      Valores permitidos: `8000`, `16000`, `22050`, `24000`, `32000`, `44100`
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="output_format" type="string" default="hex">
  Parámetro que controla el formato del resultado de salida. Los valores disponibles son url y hex; el valor predeterminado es hex. Este parámetro solo tiene efecto en escenarios no streaming; en escenarios de streaming solo se admite devolver el formato hex. La url devuelta tiene una validez de 24 horas

  Valores permitidos: `url`, `hex`
</ParamField>

<ParamField body="voice_setting" type="object">
  <Expandable title="propiedades" defaultOpen={true}>
    <ParamField body="vol" type="number" default={1}>
      Volumen del audio sintetizado. Cuanto mayor sea el valor, mayor será el volumen. Rango de valores (0, 10], valor predeterminado 1.0

      Rango de valores: \[0, 10]
    </ParamField>

    <ParamField body="pitch" type="integer" default={0}>
      Entonación del audio sintetizado. Rango de valores \[-12, 12], valor predeterminado 0, donde 0 corresponde a la salida con la voz original

      Rango de valores: \[-12, 12]
    </ParamField>

    <ParamField body="speed" type="number" default={1}>
      Velocidad de habla del audio sintetizado. Cuanto mayor sea el valor, más rápida será la velocidad. Rango de valores \[0.5, 2], valor predeterminado 1.0

      Rango de valores: \[0.5, 2]
    </ParamField>

    <ParamField body="emotion" type="string">
      Controla la emoción de la voz sintetizada. El rango de parámetros corresponde a 8 emociones: alegría (happy), tristeza (sad), ira (angry), miedo (fearful), asco (disgusted), sorpresa (surprised), neutralidad (calm), expresividad (fluent), susurro (whisper). El modelo suele emparejar automáticamente la emoción adecuada según el texto de entrada, por lo que normalmente no es necesario especificarla manualmente

      Valores permitidos: `happy`, `sad`, `angry`, `fearful`, `disgusted`, `surprised`, `calm`, `fluent`, `whisper`
    </ParamField>

    <ParamField body="voice_id" type="string" required={true}>
      Identificador de la voz para el audio sintetizado. Si necesita configurar una voz mixta, establezca el parámetro timber\_weights y deje este parámetro en blanco. Admite tres tipos: voces del sistema, voces clonadas y voces generadas a partir de texto
    </ParamField>

    <ParamField body="latex_read" type="boolean" default={false}>
      Controla si se leen fórmulas latex. El valor predeterminado es false. Solo es compatible con chino; al habilitar este parámetro, el parámetro language\_boost se establecerá en Chinese
    </ParamField>

    <ParamField body="text_normalization" type="boolean" default={false}>
      Indica si se habilita la normalización de texto en chino e inglés. Al habilitarla, puede mejorar el rendimiento en escenarios de lectura de números, pero aumentará ligeramente la latencia. El valor predeterminado es false
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="aigc_watermark" type="boolean" default={false}>
  Controla si se agrega un identificador de ritmo de audio al final del audio sintetizado. El valor predeterminado es false. Este parámetro solo tiene efecto para síntesis no streaming
</ParamField>

<ParamField body="language_boost" type="string">
  Indica si se mejora la capacidad de reconocimiento para el idioma minoritario o dialecto especificado. El valor predeterminado es null; puede establecerse en auto para que el modelo lo determine automáticamente

  Valores permitidos: `Chinese`, `Chinese,Yue`, `English`, `Arabic`, `Russian`, `Spanish`, `French`, `Portuguese`, `German`, `Turkish`, `Dutch`, `Ukrainian`, `Vietnamese`, `Indonesian`, `Japanese`, `Italian`, `Korean`, `Thai`, `Polish`, `Romanian`, `Greek`, `Czech`, `Finnish`, `Hindi`, `Bulgarian`, `Danish`, `Hebrew`, `Malay`, `Persian`, `Slovak`, `Swedish`, `Croatian`, `Filipino`, `Hungarian`, `Norwegian`, `Slovenian`, `Catalan`, `Nynorsk`, `Tamil`, `Afrikaans`, `auto`
</ParamField>

<ParamField body="stream_options" type="object">
  <Expandable title="propiedades" defaultOpen={true}>
    <ParamField body="exclude_aggregated_audio" type="boolean" default={false}>
      Configura si el último chunk contiene los datos hex de la voz concatenada. El valor predeterminado es false, es decir, el último chunk contiene los datos hex completos de la voz concatenada
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="timber_weights" type="object[]">
  Configuración de voz mixta. Admite la mezcla de hasta 4 voces

  <Expandable title="propiedades" defaultOpen={true}>
    <ParamField body="weight" type="integer" required={true}>
      Peso correspondiente a cada voz en el audio sintetizado; debe completarse junto con voice\_id. El rango de valores disponible es \[1, 100]. Admite la mezcla de hasta 4 voces. Cuanto mayor sea el peso de una sola voz, mayor será la similitud de la voz sintetizada con esa voz

      Rango de valores: \[1, 100]
    </ParamField>

    <ParamField body="voice_id" type="string" required={true}>
      Identificador de la voz para el audio sintetizado; debe completarse junto con el parámetro weight. Admite tres tipos: voces del sistema, voces clonadas y voces generadas a partir de texto
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="subtitle_enable" type="boolean" default={false}>
  Controla si se habilita el servicio de subtítulos. El valor predeterminado es false. Este parámetro solo es válido en escenarios de salida no streaming y solo para los modelos speech-2.6-hd, speech-2.6-turbo, speech-01-turbo, speech-01-hd
</ParamField>

<ParamField body="continuous_sound" type="boolean" default={false}>
  Habilite este parámetro para que las transiciones entre cláusulas sean más naturales. Solo es compatible con los modelos speech-2.8-hd y speech-2.8-turbo
</ParamField>

<ParamField body="pronunciation_dict" type="object">
  <Expandable title="propiedades" defaultOpen={true}>
    <ParamField body="tone" type="string[]">
      Define reglas de sustitución de anotación fonética o pronunciación para texto o símbolos que requieren una marca especial. En textos chinos, los tonos se representan con números: el primer tono es 1, el segundo tono es 2, el tercer tono es 3, el cuarto tono es 4 y el tono neutro es 5. Ejemplo: \["燕少飞/(yan4)(shao3)(fei1)", "omg/oh my god"]
    </ParamField>
  </Expandable>
</ParamField>

## Información de respuesta

<ResponseField name="data" type="object" required={false}>
  Objeto de datos sintetizados devuelto. Puede ser null, por lo que debe realizarse una comprobación de no nulidad
</ResponseField>

<ResponseField name="trace_id" type="string" required={false}>
  id de esta sesión, usado para ayudar a localizar problemas durante consultas o comentarios
</ResponseField>

<ResponseField name="base_resp" type="object" required={false}>
  Código de estado y detalles de esta solicitud
</ResponseField>

<ResponseField name="extra_info" type="object" required={false}>
  Información adicional del audio
</ResponseField>