curl --request POST \
--url https://api.poyo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "minimax-music-2.6",
"callback_url": "https://your-domain.com/callback",
"input": {
"prompt": "City pop, 80s retro, groovy synth bass, warm female vocal, nostalgic night drive",
"lyrics": "[Verse]\nStreetlights flicker in the rearview glow\n[Chorus]\nWe keep driving where the midnight winds blow",
"is_instrumental": false,
"audio_setting": {
"sample_rate": 44100,
"bitrate": 256000,
"format": "mp3"
}
}
}
'{
"code": 200,
"data": {
"task_id": "task-unified-1757165031-uyujaw3d",
"status": "not_started",
"created_time": "2026-04-15T10:30:00"
}
}{
"code": 400,
"error": {
"message": "Invalid request parameters",
"type": "invalid_request_error"
}
}{
"code": 400,
"error": {
"message": "Invalid request parameters",
"type": "invalid_request_error"
}
}MiniMax
MiniMax Music 2.6
MiniMax Music 2.6 API 根据风格提示词生成完整音轨，可使用提供的歌词、根据提示词生成的歌词，或纯伴奏模式。音频可按文档列出的采样率和码率以 MP3、WAV 或 PCM 返回。
POST
/
api
/
generate
/
submit
curl --request POST \
--url https://api.poyo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "minimax-music-2.6",
"callback_url": "https://your-domain.com/callback",
"input": {
"prompt": "City pop, 80s retro, groovy synth bass, warm female vocal, nostalgic night drive",
"lyrics": "[Verse]\nStreetlights flicker in the rearview glow\n[Chorus]\nWe keep driving where the midnight winds blow",
"is_instrumental": false,
"audio_setting": {
"sample_rate": 44100,
"bitrate": 256000,
"format": "mp3"
}
}
}
'{
"code": 200,
"data": {
"task_id": "task-unified-1757165031-uyujaw3d",
"status": "not_started",
"created_time": "2026-04-15T10:30:00"
}
}{
"code": 400,
"error": {
"message": "Invalid request parameters",
"type": "invalid_request_error"
}
}{
"code": 400,
"error": {
"message": "Invalid request parameters",
"type": "invalid_request_error"
}
}- 提交后会返回
task_id。如果提供了callback_url，当任务状态变为finished或failed时，系统会向callback_url发送 POST 请求。 - 无论是否提供
callback_url，都可以通过统一的查询任务状态接口获取结果。
模型
- minimax-music-2.6 — MiniMax Music 2.6
功能
- 此接口根据风格提示词生成包含演唱、伴奏和细致编曲的完整音轨
- 你可以提供自定义歌词，让模型根据提示词优化歌词，或启用纯伴奏模式生成无人声音乐
- 最终结果通过
callback_url或查询任务状态异步返回
必填参数
prompt（必填）：描述风格、情绪、流派、配器、速度或场景的音乐提示词- 长度：
10-2000个字符 - 明确说明你希望最终音轨呈现的音乐方向
- 长度：
可选参数
-
lyrics：可选，用于人声生成的歌词内容- 除非
is_instrumental或lyrics_optimizer为true，否则必填 - 最大长度：
3500个字符
- 除非
-
lyrics_optimizer：可选布尔值- 为
true且lyrics为空时，模型根据prompt自动生成歌词 - 适合想要带人声的歌曲、但不想提供具体歌词的情况
- 为
-
is_instrumental：可选布尔值- 设为
true可生成不含人声的纯伴奏音乐 - 为
true时，省略lyrics，且不要启用lyrics_optimizer
- 设为
-
audio_setting：可选的输出音频设置对象sample_rate：16000、24000、32000、44100bitrate：32000、64000、128000、256000format：mp3、wav、pcm- 仅支持这三个键
注意事项
- 如果
is_instrumental和lyrics_optimizer都为false，请提供lyrics，以免出现校验错误 lyrics_optimizer遵循上游 MiniMax Music 2.6 的 schema。如果上游服务拒绝优化歌词的请求，请改用明确的lyrics重试- 通过标准任务状态 API 查询状态，而不是音乐详情接口
- 成功响应返回
files，其中生成的音乐使用file_type: audio
授权
所有 API 接口都需要 Bearer Token 认证。
创建 API Key：登录 PoYo，进入 仪表盘 → API 密钥（poyo.ai/zh/dashboard/api-key），点击创建 Key。
在请求头中添加：
Authorization: Bearer YOUR_API_KEY
请求体
application/json
响应
任务提交成功
Show child attributes
Show child attributes