模型端点 · POST /v2/minimax/generate

MiniMax Music API

用 MiniMax Music 2.5，凭一段风格提示词和你自己的歌词生成完整歌曲——一个异步 REST 端点，支持任务轮询与 webhook 回调。

每次请求 30 积分 ≈ $0.30

一次 REST 调用背后的 MiniMax Music 2.5

MiniMax Music API 通过平台同一账户、同一 API 密钥和同一异步任务模型对外提供 MiniMax Music 2.5。提交描述目标曲目的提示词并附上歌词——MiniMax Music 2.5 必填，10–3000 字符——端点会立即返回一个 task_id。

结果通过专用的 MiniMax feed 端点返回。用你的 task_id 轮询 GET /v2/minimax/feed?workId=... 直到状态为 SUCCESS 或 FAILED，或者传入 callback_url，让平台把最终结果 POST 到你的 webhook。任务完成后，生成的音频 URL 会出现在 response 字段中。

快速上手：生成并查询 feed

向 /v2/minimax/generate 发起 POST，保存返回的 task_id，然后查询 MiniMax feed 直到歌曲就绪。

curl

curl -X POST "https://udioapi.pro/api/v2/minimax/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Cinematic orchestral pop, emotional female vocal, warm piano",
    "lyrics": "Verse 1: The city lights are fading\nChorus: We rise into the morning glow"
  }'

curl -X GET "https://udioapi.pro/api/v2/minimax/feed?workId=YOUR_TASK_ID"

每 5–10 秒轮询一次并设置总超时上限。可选的 bitrate 与 sample_rate 参数控制输出编码。

MiniMax Music 2.5 请求参数

生成端点接受一组精简参数。一次请求 30 积分——按 1 USD = 100 积分约 $0.30。

参数	类型	必填	说明
prompt	string	必填	描述曲目——流派、情绪、配器
lyrics	string	必填	10–3000 字符；MiniMax Music 2.5 必填
bitrate	number	可选	音频码率，如 256000
sample_rate	number	可选	音频采样率，如 44100
callback_url	string	可选	用于接收最终结果的公开 HTTPS webhook
public	boolean	可选	任务是否可公开

响应返回 data.task_id 和状态 IN_PROGRESS。查询 /v2/minimax/feed?workId=<task_id> 直到状态变为 SUCCESS（response 中含音频 URL）或 FAILED。

你可以构建什么

MiniMax 任务与音频 API 的其他部分并存。

工作原理

从 API 密钥到可播放音轨，只需四步。

1
创建 API 密钥
登录后打开控制台复制密钥。将其保存在服务端密钥中——切勿放进浏览器代码。
2
提交提示词与歌词
携带 prompt、lyrics 与可选编码字段向 /v2/minimax/generate 发起 POST。保存 data.task_id。
3
轮询 MiniMax feed
每 5–10 秒调用 GET /v2/minimax/feed?workId=<task_id>，或设置 callback_url 接收 webhook。
4
下载音频
状态为 SUCCESS 时，response 字段包含音频 URL。请将其持久化到自己的存储中。

按请求固定计价

每次 MiniMax Music 2.5 请求 30 积分——按 1 USD = 100 积分约 $0.30。使用 API 无需订阅；需要时充值按需积分即可。

积分永不过期。被拒绝的请求——例如歌词缺失或无效——返回 400，不按完成任务计费。

限制与说明

生成为异步；POST 返回 task_id，而非音频。
MiniMax Music 2.5 必须提供 lyrics，长度为 10–3000 字符。
每 5–10 秒轮询 /v2/minimax/feed 并设置上限，或使用 callback_url。
音频 URL 是临时的——请把结果下载到自己的存储。
MiniMax 是附加引擎；默认的音乐生成端点仍是 /v2/generate。

udioapi.pro 是独立的第三方服务，与 Suno、Udio 或 MiniMax 均无关联，未获其认可，也不由其运营。