Skip to content

歌曲生成

Mureka 的歌曲生成功能能够创建完整的音乐作品,包括人声演唱和伴奏。支持多种音乐风格、语言和创作模式,从简单的提示词到复杂的音乐参数都能精确控制。

接口信息

  • 方法: POST
  • 路径: /api/v1/music?action=song_generate
  • 功能: 生成歌曲

认证

BearerAuth Type: HTTP (bearer)

请求体

json
{
  "lyrics": "string",
  "model": "string",
  "n": integer,
  "prompt": "string",
  "reference_id": "string",
  "vocal_id": "string",
  "melody_id": "string",
  "instrumental_id": "string"
}

参数说明

字段类型必填说明
lyricsstring歌词内容 (必须)
modelstring模型版本,可选:auto,mureka-6,mureka-7.5,mureka-o1
nint每次请求生成的歌曲数量,最大值为 3,缺省为 2
promptstring歌曲提示词
reference_idstring参考音乐 ID,由 files/upload API 生成(purpose: reference)
vocal_idstring音色 ID,由 files/upload API 生成(purpose: vocal)
melody_idstring旋律 ID,由 files/upload API 生成(purpose: melody)
instrumental_idstring纯音乐参考 ID,由 files/upload API 生成(purpose: instrumental)

响应

json
{
  "code": 0,
  "message": "success",
  "resp_data": {
    "id": "task_1234567890abcdef",
    "created_at": 1640995200,
    "finished_at": 0,
    "model": "mureka-7.5",
    "status": "preparing",
    "failed_reason": "",
    "watermarked": false,
    "choices": []
  }
}

请求示例

JSON 示例

json
{
  "lyrics": "【Verse 1】\n青春如花绽放\n梦想在心中飞翔\n\n【Chorus】\n青春与梦想\n永远在心中",
  "model": "mureka-7.5",
  "n": 2,
  "prompt": "创作一首关于青春梦想的流行歌曲"
}

cURL 示例

bash
curl -X POST "[HOST]/api/v1/music?action=song_generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "lyrics": "【Verse 1】\n青春如花绽放\n梦想在心中飞翔\n\n【Chorus】\n青春与梦想\n永远在心中",
    "model": "mureka-7.5",
    "n": 2,
    "prompt": "创作一首关于青春梦想的流行歌曲"
  }'