MiniMax Music
Endpoint: POST https://vod.intl.tencentcloudapi.comAction: CreateAigcAudioTask
MiniMax Music 是音乐生成模型,可根据提示词与指定歌词生成歌曲,输出 MP3(44.1kHz)。提供 3.0、2.6、2.5、2.0 多个版本。
基本信息
| 项目 | 取值 |
|---|---|
| ModelName | MiniMaxMusic |
| ModelVersion | 3.0 / 2.6 / 2.5 / 2.0 |
| SceneType | music |
| 输出比特率 | 在生成文件的元数据中确认 |
| 输出长度 | 随模型与请求选项而变化,在结果元数据中确认 |
| 输出规格 | MP3,44.1kHz 立体声 |
| 任务完成 | 以查询 API 的完成状态确认 |
可直接填入歌词。
请求参数
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
ModelName | 必填 | String | 固定值 MiniMaxMusic |
ModelVersion | 可选 | String | 3.0 / 2.6 / 2.5 / 2.0 |
SceneType | 必填 | String | music |
Prompt | 必填 | String | 曲目氛围与风格提示词 |
AdditionalParameters | 可选 | String | lyrics(歌词),instrumental(是否去除人声,Boolean) |
请求示例
json
{
"SubAppId": 123456789,
"ModelName": "MiniMaxMusic",
"ModelVersion": "2.6",
"SceneType": "music",
"Prompt": "a cheerful pop song, upbeat tempo",
"AdditionalParameters": "{\"lyrics\": \"Sunlight on the windowsill, a new day has begun\"}"
}json
{
"SubAppId": 123456789,
"ModelName": "MiniMaxMusic",
"ModelVersion": "3.0",
"SceneType": "music",
"Prompt": "lo-fi hip hop beat for study background",
"AdditionalParameters": "{\"instrumental\": true}"
}响应示例
json
{
"AigcAudioTask": {
"Status": "FINISH",
"ErrCode": 0,
"Output": {
"AudioInfos": [
{
"FileUrl": "http://<host>.vod2.myqcloud.com/.../aigcAudioGenFile.mp3"
}
]
}
}
}模型专用音频选项
| 模型 | 字段 | 说明 |
|---|---|---|
MiniMaxMusic | lyrics | 歌词 |
MiniMaxMusic | instrumental | 是否去除人声。Boolean |
MiniMaxMusic | sample_rate / bitrate | 输出音频规格 |
特殊设置
版本选择
| ModelVersion | 特点 |
|---|---|
3.0 | 3.0 系列 |
2.6 | 2.6 系列 |
2.5 | 旧版本 |
2.0 | 初始版本 |
歌词指定 (lyrics)
歌词通过 AdditionalParameters 的 lyrics 字段传递。在 Prompt 中写入曲目的氛围与风格。
json
{
"SubAppId": 123456789,
"ModelName": "MiniMaxMusic",
"ModelVersion": "3.0",
"SceneType": "music",
"Prompt": "a bright and cheerful pop song",
"AdditionalParameters": "{\"lyrics\": \"Sunlight on the windowsill, a new day has begun\"}",
"OutputConfig": {
"StorageMode": "Temporary",
"OutputAudioFormat": "mp3"
}
}AdditionalParameters
| 字段 | 类型 | 说明 |
|---|---|---|
lyrics | String | 歌词 |
instrumental | Boolean | 去除人声。仅生成伴奏 |
sample_rate | Integer | 输出采样率 |
bitrate | Integer | 输出比特率 |
输出比特率固定为 32 kbps
MiniMaxMusic 输出 32 kbps MP3。192 kbps 输出请使用 GL。
乐曲生成
将 instrumental 指定为 true。
json
{
"SubAppId": 123456789,
"ModelName": "MiniMaxMusic",
"ModelVersion": "3.0",
"SceneType": "music",
"Prompt": "lo-fi hip hop beat for study background",
"AdditionalParameters": "{\"instrumental\": true}"
}输出格式
用 OutputConfig.OutputAudioFormat 指定结果文件格式。
json
{
"OutputConfig": {
"StorageMode": "Temporary",
"OutputAudioFormat": "mp3"
}
}附加选项
VOD 的人声控制使用 instrumental,MPS 使用 is_instrumental Boolean 值。MiniMaxMusic 的输出为 32 kbps MP3。