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

MiniMax AI music generation model. Supports creating AI music from text descriptions and lyrics, covering a variety of music styles, moods, and scenarios.

## Request Headers

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

<ParamField header="Authorization" type="string" required={true}>
  Bearer authentication format: Bearer \{\{API Key}}.
</ParamField>

## Request Body

<ParamField body="model" type="string" required={true}>
  Model version. music-2.5+ is the latest recommended version and supports instrumental music generation; music-2.5 is the standard version; music-2.0 is the basic version.

  Available values: `music-2.5+`, `music-2.5`, `music-2.0`
</ParamField>

<ParamField body="lyrics" type="string">
  Lyrics content, with lines separated by \n. Supports structure tags: \[Intro], \[Verse], \[Pre Chorus], \[Chorus], \[Interlude], \[Bridge], \[Outro], \[Post Chorus], \[Transition], \[Break], \[Hook], \[Build Up], \[Inst], \[Solo]

  Length limit: 0 - 3500
</ParamField>

<ParamField body="prompt" type="string">
  Music description used to specify information such as music style, mood, and scenario. When is\_instrumental is true (music-2.5+), prompt is required.

  Length limit: 0 - 2000
</ParamField>

<ParamField body="audio_setting" type="object">
  Audio parameter settings

  <Expandable title="properties" defaultOpen={true}>
    <ParamField body="format" type="string">
      Audio encoding format

      Available values: `mp3`, `wav`, `pcm`
    </ParamField>

    <ParamField body="bitrate" type="integer">
      Bitrate

      Available values: `32000`, `64000`, `128000`, `256000`
    </ParamField>

    <ParamField body="sample_rate" type="integer">
      Sample rate

      Available values: `16000`, `24000`, `32000`, `44100`
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="output_format" type="string" default="url">
  Output format, fixed as url, returns an audio link.

  Available values: `url`
</ParamField>

<ParamField body="aigc_watermark" type="boolean" default={false}>
  Whether to add an AIGC watermark at the end of the audio.
</ParamField>

<ParamField body="is_instrumental" type="boolean" default={false}>
  Generate instrumental music (no vocals). Only supported by music-2.5+; when enabled, prompt is required.
</ParamField>

<ParamField body="lyrics_optimizer" type="boolean" default={false}>
  When enabled, if lyrics is empty, lyrics will be automatically generated based on prompt. Only supported by music-2.5 and music-2.5+.
</ParamField>

## Response Information

<ResponseField name="audios" type="string[]" required={false}>
  List of generated audio

  Audio URL
</ResponseField>
