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

# MiniMax Music

Modelo de geração de música por IA da MiniMax, com suporte à criação de música por IA por meio de descrições em texto e letras, abrangendo diversos estilos musicais, emoções e cenários

## 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 \{\{Chave de API}}.
</ParamField>

## Corpo da solicitação

<ParamField body="model" type="string" required={true}>
  Versão do modelo. music-2.5+ é a versão recomendada mais recente e oferece suporte à geração de música instrumental; music-2.5 é a versão padrão; music-2.0 é a versão básica

  Valores opcionais: `music-2.5+`, `music-2.5`, `music-2.0`
</ParamField>

<ParamField body="lyrics" type="string">
  Conteúdo da letra, usando \n para separar linhas. Oferece suporte a tags estruturais: \[Intro]、\[Verse]、\[Pre Chorus]、\[Chorus]、\[Interlude]、\[Bridge]、\[Outro]、\[Post Chorus]、\[Transition]、\[Break]、\[Hook]、\[Build Up]、\[Inst]、\[Solo]

  Limite de comprimento: 0 - 3500
</ParamField>

<ParamField body="prompt" type="string">
  Descrição da música, usada para especificar informações como estilo musical, emoção, cenário etc. Quando is\_instrumental for true (music-2.5+), prompt será obrigatório

  Limite de comprimento: 0 - 2000
</ParamField>

<ParamField body="audio_setting" type="object">
  Configuração dos parâmetros de áudio

  <Expandable title="properties" defaultOpen={true}>
    <ParamField body="format" type="string">
      Formato de codificação de áudio

      Valores opcionais: `mp3`, `wav`, `pcm`
    </ParamField>

    <ParamField body="bitrate" type="integer">
      Taxa de bits

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

    <ParamField body="sample_rate" type="integer">
      Taxa de amostragem

      Valores opcionais: `16000`, `24000`, `32000`, `44100`
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="output_format" type="string" default="url">
  Formato de saída, fixo como url, retorna o link do áudio

  Valores opcionais: `url`
</ParamField>

<ParamField body="aigc_watermark" type="boolean" default={false}>
  Indica se deve adicionar uma marca d'água AIGC ao final do áudio
</ParamField>

<ParamField body="is_instrumental" type="boolean" default={false}>
  Gera música instrumental (sem vocais). Compatível apenas com music-2.5+; quando ativado, prompt é obrigatório
</ParamField>

<ParamField body="lyrics_optimizer" type="boolean" default={false}>
  Quando ativado, se lyrics estiver vazio, gera letras automaticamente com base em prompt. Compatível apenas com music-2.5 e music-2.5+
</ParamField>

## Informações da resposta

<ResponseField name="audios" type="string[]" required={false}>
  Lista de áudios gerados

  URL do áudio
</ResponseField>