> ## 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íntese de voz síncrona MiniMax Speech-2.6-hd

Esta API oferece suporte à geração síncrona baseada em texto para fala, com transmissão máxima de 10000 caracteres por vez. Oferece suporte a mais de 100 vozes de sistema e à escolha autônoma de vozes clonadas; permite ajustar volume, entonação, velocidade e formato de saída; oferece suporte a mistura de vozes por proporção e controle de intervalos fixos; oferece suporte a várias especificações e formatos de áudio, incluindo: mp3, pcm, flac, wav, além de saída em streaming.

Após enviar uma solicitação de síntese de voz de texto longo, observe que a URL retornada é válida por 24 horas a partir do momento em que a URL é retornada. Preste atenção ao prazo para baixar as informações.

<Tip>Adequado para cenários como geração de frases curtas, chat por voz e socialização online. Tem baixa latência, mas o limite de comprimento do texto é inferior a 10000 caracteres. Para textos longos, recomenda-se usar [síntese de voz por chamada assíncrona](/pt/docs/models/reference-minimax-speech-2.6-hd-async).</Tip>

## Cabeçalhos da solicitação

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

<ParamField header="Authorization" type="string" required={true}>
  Formato de autenticação Bearer: Bearer \{\{API Key}}.
</ParamField>

## Corpo da solicitação

<ParamField body="text" type="string" required={true}>
  Texto a ser sintetizado, com limite de comprimento inferior a 10000 caracteres. Use quebras de linha para substituir mudanças de parágrafo. (Se for necessário controlar o intervalo de tempo na fala, adicione \<#x#> entre os caracteres; a unidade de x é segundos, com suporte de 0.01 a 99.99 e no máximo duas casas decimais). Oferece suporte à personalização do intervalo de tempo de fala entre textos, para obter o efeito de pausas personalizadas na fala do texto. Observe que o intervalo de tempo entre textos deve ser definido entre dois textos que possam ser pronunciados por voz, e não é permitido definir vários intervalos de tempo consecutivos.
</ParamField>

<ParamField body="voice_setting" type="object" required={true}>
  <Expandable title="propriedades">
    <ParamField body="speed" type="float" default="1.0">
      Intervalo \[0.5,2], valor padrão 1.0

      Velocidade da fala gerada. Opcional; quanto maior o valor, mais rápida a fala.
    </ParamField>

    <ParamField body="vol" type="float" default="1.0">
      Intervalo (0,10], valor padrão 1.0

      Volume da fala gerada. Opcional; quanto maior o valor, mais alto o volume.
    </ParamField>

    <ParamField body="pitch" type="int" default="0">
      Intervalo \[-12,12], valor padrão 0

      Entonação da fala gerada. Opcional (0 corresponde à saída da voz original; o valor deve ser um inteiro).
    </ParamField>

    <ParamField body="voice_id" type="string">
      ID da voz solicitada. Obrigatório escolher um entre este campo e timbre\_weights.

      Oferece suporte a dois tipos: vozes de sistema (id) e vozes clonadas (id). As vozes de sistema (ID) são as seguintes:

      * Voz jovem ingênua masculina: `male-qn-qingse`
      * Voz jovem elite masculina: `male-qn-jingying`
      * Voz jovem dominadora masculina: `male-qn-badao`
      * Voz de estudante universitário masculino: `male-qn-daxuesheng`
      * Voz de garota: `female-shaonv`
      * Voz feminina madura e confiante: `female-yujie`
      * Voz feminina madura: `female-chengshu`
      * Voz feminina doce: `female-tianmei`
      * Apresentador masculino: `presenter_male`
      * Apresentadora feminina: `presenter_female`
      * Audiolivro masculino 1: `audiobook_male_1`
      * Audiolivro masculino 2: `audiobook_male_2`
      * Audiolivro feminino 1: `audiobook_female_1`
      * Audiolivro feminino 2: `audiobook_female_2`
      * Voz jovem ingênua masculina-beta: `male-qn-qingse-jingpin`
      * Voz jovem elite masculina-beta: `male-qn-jingying-jingpin`
      * Voz jovem dominadora masculina-beta: `male-qn-badao-jingpin`
      * Voz de estudante universitário masculino-beta: `male-qn-daxuesheng-jingpin`
      * Voz de garota-beta: `female-shaonv-jingpin`
      * Voz feminina madura e confiante-beta: `female-yujie-jingpin`
      * Voz feminina madura-beta: `female-chengshu-jingpin`
      * Voz feminina doce-beta: `female-tianmei-jingpin`
      * Menino inteligente: `clever_boy`
      * Menino fofo: `cute_boy`
      * Menina adorável: `lovely_girl`
      * Porquinho de desenho Xiaoqi: `cartoon_pig`
      * Irmão mais novo obcecado: `bingjiao_didi`
      * Namorado bonito: `junlang_nanyou`
      * Colega mais novo inocente: `chunzhen_xuedi`
      * Colega mais velho frio: `lengdan_xiongzhang`
      * Jovem mestre dominador: `badao_shaoye`
      * Docinho Xiaoling: `tianxin_xiaoling`
      * Garota fofa e brincalhona: `qiaopi_mengmei`
      * Mulher madura sedutora: `wumei_yujie`
      * Colega mais nova meiga: `diadia_xuemei`
      * Colega mais velha elegante: `danya_xuejie`
      * Santa Claus: `Santa_Claus`
      * Grinch: `Grinch`
      * Rudolph: `Rudolph`
      * Arnold: `Arnold`
      * Charming Santa: `Charming_Santa`
      * Charming Lady: `Charming_Lady`
      * Sweet Girl: `Sweet_Girl`
      * Cute Elf: `Cute_Elf`
      * Attractive Girl: `Attractive_Girl`
      * Serene Woman: `Serene_Woman`
    </ParamField>

    <ParamField body="emotion" type="string">
      Controla a emoção da fala sintetizada;

      Atualmente, há suporte a 7 emoções: alegria, tristeza, raiva, medo, nojo, surpresa e neutro;

      Intervalo do parâmetro: `["happy", "sad", "angry", "fearful", "disgusted", "surprised", "neutral"]`
    </ParamField>

    <ParamField body="latex_read" type="bool" default="false">
      Controla se há suporte à leitura de fórmulas latex. O padrão é false.

      Observações:

      1. As fórmulas na solicitação precisam incluir \$\$ no início e no fim;
      2. Se uma fórmula na solicitação contiver "", é necessário escapá-la como "\\".

      Exemplo: a fórmula básica da derivada é `$$\\frac{d}{dx}(x^n) = nx^{n-1}$$`
    </ParamField>

    <ParamField body="text_normalization" type="bool" default="false">
      Este parâmetro oferece suporte à normalização de texto em inglês e pode melhorar o desempenho em cenários de leitura de números, mas aumentará ligeiramente a latência. Se não for fornecido, o valor padrão será false.
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="audio_setting" type="object">
  <Expandable title="propriedades">
    <ParamField body="sample_rate" type="int" default="32000">
      Intervalo 【8000，16000，22050，24000，32000，44100】

      Taxa de amostragem da fala gerada. Opcional, padrão 32000.
    </ParamField>

    <ParamField body="bitrate" type="int" default="128000">
      Intervalo 【32000，64000，128000，256000】

      Taxa de bits da fala gerada. Opcional, valor padrão 128000. Este parâmetro só se aplica a áudio no formato mp3.
    </ParamField>

    <ParamField body="format" type="string" default="mp3">
      Formato do áudio gerado. Padrão mp3, intervalo \[mp3,pcm,flac,wav]. wav só é compatível em saída não streaming.
    </ParamField>

    <ParamField body="channel" type="int" default="1">
      Número de canais do áudio gerado. Padrão 1: mono. Opções:

      1: mono

      2: estéreo
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="pronunciation_dict" type="object">
  <Expandable title="propriedades">
    <ParamField body="tone" type="list">
      Substitui textos, símbolos e suas respectivas pronúncias que precisam de marcação especial.

      Substituição de pronúncia (ajuste de tom/substituição da pronúncia de outros caracteres), no seguinte formato:

      `["燕少飞/(yan4)(shao3)(fei1)","达菲/(da2)(fei1)"，"omg/oh my god"]`

      Os tons são representados por números: primeiro tom (yinping) é 1, segundo tom (yangping) é 2, terceiro tom (shangsheng) é 3, quarto tom (qusheng) é 4, e tom neutro é 5.
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="timbre_weights" type="object[]">
  Obrigatório escolher um entre este campo e voice\_id

  <Expandable title="propriedades">
    <ParamField body="voice_id" type="string">
      ID da voz solicitada. Deve ser preenchido em conjunto com o parâmetro weight.
    </ParamField>

    <ParamField body="weight" type="int">
      Intervalo \[1,100]

      Peso. Deve ser preenchido em conjunto com voice\_id. Oferece suporte à mistura de no máximo 4 vozes. O valor deve ser inteiro; quanto maior a proporção de uma única voz, mais a voz sintetizada se parecerá com ela.
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="stream" type="boolean" default="false">
  Indica se a saída será em streaming. O padrão é false, ou seja, streaming desativado.
</ParamField>

<ParamField body="stream_options" type="object">
  <Expandable title="propriedades">
    <ParamField body="exclude_aggregated_audio" type="boolean" default="false">
      Quando este parâmetro é definido como True, o último chunk do streaming não conterá os dados hex completos da fala concatenada. O padrão é False, ou seja, o último chunk contém os dados hex completos da fala concatenada.
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="language_boost" type="string" default="null">
  Melhora a capacidade de reconhecimento para idiomas minoritários e dialetos especificados. Após a configuração, pode melhorar o desempenho de voz em cenários do idioma minoritário/dialeto especificado. Se o tipo de idioma minoritário não estiver claro, você pode escolher "auto", e o modelo determinará automaticamente o tipo de idioma minoritário. Oferece suporte aos seguintes valores:

  `'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="output_format" type="string" default="hex">
  Parâmetro que controla a forma do resultado de saída. Os valores opcionais são `url` e `hex`. O valor padrão é `hex`. Este parâmetro só tem efeito em cenários não streaming; cenários de streaming oferecem suporte apenas ao retorno no formato hex. A URL retornada é válida por 24 horas.
</ParamField>

<ParamField body="voice_modify" type="object">
  Configurações de efeitos de voz. Este parâmetro oferece suporte aos seguintes formatos de áudio:

  * Não streaming: mp3, wav, flac
  * Streaming: mp3

  <Expandable title="propriedades">
    <ParamField body="pitch" type="integer">
      Ajuste de altura (grave/brilhante), intervalo \[-100,100]. Valores próximos de -100 tornam a voz mais grave; valores próximos de 100 tornam a voz mais brilhante.
    </ParamField>

    <ParamField body="intensity" type="integer">
      Ajuste de intensidade (força/suavidade), intervalo \[-100,100]. Valores próximos de -100 tornam a voz mais firme; valores próximos de 100 tornam a voz mais suave.
    </ParamField>

    <ParamField body="timbre" type="integer">
      Ajuste de timbre (magnético/cristalino), intervalo \[-100,100]. Valores próximos de -100 tornam a voz mais encorpada; valores próximos de 100 tornam a voz mais cristalina.
    </ParamField>

    <ParamField body="sound_effects" type="string">
      Configuração de efeito sonoro. Só é possível escolher um por vez. Valores opcionais:

      * `spacious_echo` (eco amplo)
      * `auditorium_echo` (transmissão de auditório)
      * `lofi_telephone` (distorção de telefone)
      * `robotic` (voz eletrônica)
    </ParamField>
  </Expandable>
</ParamField>

## Informações de resposta

<ResponseField name="audio" type="string">
  Trecho de áudio após a síntese, codificado em hex, gerado de acordo com o formato definido na entrada (`audio_setting.format`) (mp3/pcm/flac). A forma de retorno depende da definição de `output_format`; quando `stream` é true, apenas o formato de retorno hex é compatível.
</ResponseField>

<ResponseField name="status" type="number">
  Status atual do fluxo de áudio, retornado apenas quando `stream` é true. 1 indica que a síntese está em andamento; 2 indica que a síntese foi concluída.
</ResponseField>