Skip to content

音乐 ​

← 返回全部能力

用一段风格提示词加一段歌词,生成一首完整的歌。提交是异步的:先拿任务号,再轮询取结果。

接口一览 ​

接口方法与路径说明
提交生成任务POST /v1/music/generations返回任务号,此时还没有音频地址
轮询任务结果GET /v1/music/generations/{task_id}查询进度,完成后返回音频地址

基地址 https://api.jcaigc.cn/v1,请求头带 Authorization: Bearer <密钥>(也接受 x-api-key),密钥是控制台里的 apiKey。

支持的模型 ​

模型说明
minimax-music-2.0MiniMax Music 2.0,成本更低的一档
minimax-music-3.0MiniMax Music 3.0,更新的编曲与演唱效果,支持采样率与码率设置

两款模型都由 MiniMaxMusic 承接,一次任务生成一首完整的歌。调用 GET /v1/models 可以拿到当前账号可用的准确清单。

请求参数 ​

参数必填说明
model是模型名,取值见上表
prompt是风格提示词,描述曲风、乐器、人声音色与情绪
lyrics否歌词;可用 [Verse] / [Chorus] 标注段落,留空则由模型按风格自行发挥
output_format否输出格式,mp3 / wav / flac,缺省 mp3;别名 format 同样接受
sample_rate否采样率(Hz),仅 minimax-music-3.0 支持
bitrate否码率(bps),仅 minimax-music-3.0 支持

音频地址有效期

生成结果保存在临时存储里,音频地址7 天后失效。需要长期保存时,请在拿到地址后及时下载。

提交响应 ​

提交成功即刻返回(HTTP 200),此时歌还没生成好:

json
{
  "id": "task_...",
  "task_id": "task_...",
  "object": "music.generation",
  "created": 1699999999,
  "model": "minimax-music-3.0",
  "status": "queued",
  "progress": 0
}

id 与 task_id 是同一个值的两个别名,按客户端习惯取用即可。

轮询响应 ​

json
{
  "id": "task_...",
  "status": "succeeded",
  "progress": 100,
  "data": [{ "url": "https://..." }],
  "audio_url": "https://..."
}
status含义
queued排队中
processing生成中
succeeded已完成,读 audio_url 或 data[0].url
failed失败,读 error.message
expired超时未取走结果

轮询规则

轮询不计费。网关对上游的查询最多每 2 秒一次,更密的请求会由网关直接返回缓存状态,不会真的打到上游。 任务超过 30 分钟没有轮询到终态会转为 expired,此时预扣的费用不退还,所以提交后请及时轮询。

任务只对提交它的账号可见

轮询要带提交时用的那把密钥。换了密钥或换了账号来查,网关一律返回 404(错误码 task_not_found), 既查不到别人的任务,也不会泄漏任务是否存在。

请求示例 ​

bash
# 1. 提交任务
curl -X POST https://api.jcaigc.cn/v1/music/generations \
  -H "Authorization: Bearer 123e4567-e89b-12d3-a456-426614174000" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax-music-3.0",
    "prompt": "轻快的民谣流行歌曲,温暖的木吉他扫弦,钢琴点缀,男声温柔治愈,节奏舒缓",
    "lyrics": "[Verse]\n晨光落在安静的窗台\n风把昨天轻轻吹开\n\n[Chorus]\n就让阳光铺满肩膀\n让脚步跟着节拍摇晃",
    "output_format": "mp3"
  }'

# 2. 轮询结果,拿到 status=succeeded 即结束
curl https://api.jcaigc.cn/v1/music/generations/task_你的任务号 \
  -H "Authorization: Bearer 123e4567-e89b-12d3-a456-426614174000"

计费说明 ​

音乐生成按次计费:一次任务固定收一次价,音频时长与歌词长度都不影响金额。

模型单价
minimax-music-2.00.25 元/次
minimax-music-3.01 元/次
  • 失败任务全额退还;expired 任务不退还。
  • 提交时按所选模型的一次价预扣,任务完成结算时金额不变,不产生时长或字符数补差。
  • 上表是网关的出厂价目表,线上实际生效的单价以控制台「模型与定价」展示的为准; 价目表里没有条目的模型一律拒绝调用(HTTP 503,error.type = model_not_priced),不会回落到任何默认价。

相关模块 ​

  • 语音 — 语音识别与语音合成
  • 视频 — 文生视频与图生视频
  • 大语言模型 — 用模型批量生成歌词与风格提示词

最后更新于: