curl --request POST \
--url https://api.vidgo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "minimax/music-2.6",
"input": {
"prompt": "City pop, 100 BPM, warm female vocals, electric piano, rounded synth bass and a nostalgic evening mood",
"lyrics": "[Verse]\nThe evening lights begin to glow\nWe follow streets we used to know\n[Chorus]\nCarry the melody into the night\nFollow the rhythm until morning light",
"lyrics_optimizer": false,
"is_instrumental": false,
"audio_setting": {
"sample_rate": 44100,
"bitrate": 256000,
"format": "mp3"
}
}
}
'{
"code": 200,
"data": {
"task_id": "task-unified-example",
"status": "running",
"created_time": "2026-09-10T08:00:00"
}
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}Request timeout{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}MiniMax
MiniMax Music 2.6
MiniMax Music 2.6 API 根据风格提示词生成歌曲和纯音乐，支持自定义歌词、自动生成歌词以及可配置的音频输出。
POST
/
api
/
generate
/
submit
curl --request POST \
--url https://api.vidgo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "minimax/music-2.6",
"input": {
"prompt": "City pop, 100 BPM, warm female vocals, electric piano, rounded synth bass and a nostalgic evening mood",
"lyrics": "[Verse]\nThe evening lights begin to glow\nWe follow streets we used to know\n[Chorus]\nCarry the melody into the night\nFollow the rhythm until morning light",
"lyrics_optimizer": false,
"is_instrumental": false,
"audio_setting": {
"sample_rate": 44100,
"bitrate": 256000,
"format": "mp3"
}
}
}
'{
"code": 200,
"data": {
"task_id": "task-unified-example",
"status": "running",
"created_time": "2026-09-10T08:00:00"
}
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}Request timeout{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}- 提交后会返回
task_id。如果提供了callback_url，当任务状态变为finished或failed时，系统会向callback_url发送 POST 请求。 - 无论是否提供
callback_url，都可以通过统一的查询任务状态接口获取结果。
模型
将model 设为 minimax/music-2.6。音乐参数放在 input 中，可选的 callback_url 放在请求根级。
音乐参数
prompt：必填字符串，10-2000 个字符，描述音乐方向。lyrics：歌词字符串，最多 3500 个字符。is_instrumental和lyrics_optimizer都为false时需提供歌词。可以使用[Verse]、[Chorus]等段落标签组织歌词。lyrics_optimizer：布尔值，默认false。为true且lyrics为空时，根据prompt生成歌词。is_instrumental：布尔值，默认false。设为true生成纯音乐，此时lyrics留空，lyrics_optimizer设为false。
创作模式
自定义歌词
在prompt 中写音乐方向，在 lyrics 中写要演唱的歌词。is_instrumental 保持为 false。
自动生成歌词
在prompt 中描述音乐风格、歌曲主题和人声特点。将 lyrics_optimizer 设为 true，lyrics 留空，is_instrumental 设为 false。
纯音乐
在prompt 中描述乐器、节奏和氛围。将 is_instrumental 设为 true，lyrics 留空，lyrics_optimizer 设为 false。
音频设置
audio_setting 是可选对象，包含以下字段：
sample_rate：采样率（Hz）。可选值：16000、24000、32000、44100。默认：44100。bitrate：比特率（bit/s）。可选值：32000、64000、128000、256000。默认：256000。format：音频格式。可选值：mp3、wav、pcm。默认：mp3。
获取音频
使用提交响应中的标识符查询GET /api/generate/status/{task_id}。状态为 not_started 或 running 时继续查询。
状态为 finished 时，读取 files 数组，使用 file_type: "audio" 条目中的 file_url 获取音乐。任务 failed 时，读取 error_message，检查请求后再重试。授权
使用 VIDGO_API_KEY。
请求体
application/json
在请求根级设置 model 和可选的 callback_url，音乐参数放在 input 中。
MiniMax Music 2.6 的模型标识。
可用选项:
minimax/music-2.6 示例:
"minimax/music-2.6"
生成带人声的音乐时提供 lyrics；lyrics 留空并启用 lyrics_optimizer 可自动写词；或将 is_instrumental 设为 true，lyrics 留空且 lyrics_optimizer 为 false。
Show child attributes
Show child attributes
可选的 HTTP(S) 回调 URL，用于接收任务完成或失败的通知。