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

# MiniMax Music

MiniMax AI音乐生成模型，支持通过文本描述和歌词创作AI音乐，涵盖多种音乐风格、情绪和场景

## 请求头

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

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

## 请求体

<ParamField body="model" type="string" required={true}>
  模型版本。music-2.5+为最新推荐版本，支持纯音乐生成；music-2.5为标准版本；music-2.0为基础版本

  可选值：`music-2.5+`, `music-2.5`, `music-2.0`
</ParamField>

<ParamField body="lyrics" type="string">
  歌词内容，使用\n分隔行。支持结构标签：\[Intro]、\[Verse]、\[Pre Chorus]、\[Chorus]、\[Interlude]、\[Bridge]、\[Outro]、\[Post Chorus]、\[Transition]、\[Break]、\[Hook]、\[Build Up]、\[Inst]、\[Solo]

  长度限制：0 - 3500
</ParamField>

<ParamField body="prompt" type="string">
  音乐描述，用于指定音乐风格、情绪、场景等信息。当is\_instrumental为true时（music-2.5+），prompt为必填

  长度限制：0 - 2000
</ParamField>

<ParamField body="audio_setting" type="object">
  音频参数设置

  <Expandable title="properties" defaultOpen={true}>
    <ParamField body="format" type="string">
      音频编码格式

      可选值：`mp3`, `wav`, `pcm`
    </ParamField>

    <ParamField body="bitrate" type="integer">
      比特率

      可选值：`32000`, `64000`, `128000`, `256000`
    </ParamField>

    <ParamField body="sample_rate" type="integer">
      采样率

      可选值：`16000`, `24000`, `32000`, `44100`
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="output_format" type="string" default="url">
  输出格式，固定为url，返回音频链接

  可选值：`url`
</ParamField>

<ParamField body="aigc_watermark" type="boolean" default={false}>
  是否在音频末尾添加AIGC水印
</ParamField>

<ParamField body="is_instrumental" type="boolean" default={false}>
  生成纯音乐（无人声）。仅music-2.5+支持，启用时prompt为必填
</ParamField>

<ParamField body="lyrics_optimizer" type="boolean" default={false}>
  启用后，当lyrics为空时自动根据prompt生成歌词。仅music-2.5和music-2.5+支持
</ParamField>

## 响应

<ResponseField name="audios" type="array">
  生成的音频列表
</ResponseField>
