歌曲生成
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"
}参数说明
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| lyrics | string | 是 | 歌词内容 (必须) |
| model | string | 否 | 模型版本,可选:auto,mureka-6,mureka-7.5,mureka-o1 |
| n | int | 否 | 每次请求生成的歌曲数量,最大值为 3,缺省为 2 |
| prompt | string | 否 | 歌曲提示词 |
| reference_id | string | 否 | 参考音乐 ID,由 files/upload API 生成(purpose: reference) |
| vocal_id | string | 否 | 音色 ID,由 files/upload API 生成(purpose: vocal) |
| melody_id | string | 否 | 旋律 ID,由 files/upload API 生成(purpose: melody) |
| instrumental_id | string | 否 | 纯音乐参考 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": "创作一首关于青春梦想的流行歌曲"
}'