音乐生成

音乐生成为同步接口：上游（MiniMax）为服务端流式，代理层在服务端消费完整个流后，一次性返回聚合结果，客户端无需处理流式。

POST https://api.smartapi.cc/api/openapi/v1/generate/music/generations

鉴权#

Authorization: Bearer sk-your-key-here
Content-Type: application/json

请求体#

字段	类型	必填	说明
`model`	string	是	模型标识，例如 `minimax-music-2.0`。
`lyrics`	string	是	歌词。不能为空，可用 `\n` 分行，支持 `[verse]`/`[chorus]` 等结构标记。
`prompt`	string	否	风格/情绪描述（曲风、乐器、节奏等）。
`output_format`	string	否	输出形态，如 `url`（返回可播放链接）或 `hex`（返回十六进制音频）。
`aigc_watermark`	boolean	否	是否加 AIGC 水印。
`audio_setting`	object	否	音频参数，见下表。

audio_setting 可选字段：

字段	类型	说明
`sample_rate`	number	采样率，如 `16000`、`24000`、`32000`、`44100`
`bitrate`	number	码率，如 `32000`、`64000`、`128000`、`256000`
`format`	string	音频格式，如 `mp3`、`wav`、`pcm`

各模型该传哪些字段、可选值，可在模型广场查看；也可在操练场选中模型，打开「自定义请求体 / 调试」查看实际请求体。

示例#

curl https://api.smartapi.cc/api/openapi/v1/generate/music/generations \
  -H "Authorization: Bearer $SMARTAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax-music-2.0",
    "prompt": "轻快的流行电子，明亮的合成器与鼓点",
    "lyrics": "[verse]\n夜色里我们奔跑\n追着风的方向\n[chorus]\n点亮整片星空\n不再回头张望",
    "output_format": "url",
    "audio_setting": { "sample_rate": 44100, "bitrate": 256000, "format": "mp3" }
  }'

响应#

上游原始 JSON 会被原样透传。当 output_format=url 时通常包含可播放链接：

{
  "data": { "audio_url": "https://.../result.mp3", "status": 2 },
  "base_resp": { "status_code": 0, "status_msg": "success" }
}

当 output_format=hex 时，音频以十六进制字符串返回（如 data.audio），需自行解码为音频文件。若上游校验失败或出错，接口会返回上游的原始错误信息，便于排查。

lyrics（歌词）为必填，缺失会直接返回参数错误。音乐生成耗时通常较长，请为请求设置足够的超时时间。

计费#

音乐模型按积分计费（不是 token）。minimax-music-2.0 为按次计费：每首（时长 ≤5 分钟）固定积分，与歌词长度、audio_setting 参数无关，仅在成功后扣费。各模型单价见模型广场，计费口径详见计费。