生成纯音乐
Mureka 的纯音乐生成功能专注于创作无歌词的器乐作品,适合背景音乐、配乐、环境音乐等场景。支持多种音乐风格和复杂度设置。
接口信息
- 方法: POST
- 路径:
/api/v1/music?action=instrumental_generate
认证方式
- 类型: HTTP Bearer 认证
- 说明: 需在请求头中携带
Authorization: Bearer YOUR_API_KEY
请求体
json
{
"prompt": "创作一首宁静的钢琴背景音乐,适合冥想和放松",
"model": "auto"
}Parameter Description
| Field | Type | Required | Description |
|---|---|---|---|
| model | string | No | 要使用的模型。使用 auto 选择常规模型的最新版。可选:auto,mureka-6,mureka-7.5 |
| n | int | No | 每次请求生成的纯音乐数量,最大值为3,缺省为2. 注意会根据数量计费。 |
| prompt | string | No | 通过输入提示词控制纯音乐的生成,最大1024个字符。选择此选项时,其他控制选项(instrumental_id)不能选择。 |
| instrumental_id | string | No | 通过参考音乐控制纯音乐的生成,由files/upload API生成(purpose: instrumental)。选择此选项时,其他控制选项(prompt)不能选择。 |
响应示例
json
{
"code": 200,
"code_msg": "Success",
"trace_id": "5ec4ba9f5673e938",
"resp_data": {
"id": "102512780705796",
"created_at": 1761560304,
"finished_at": 0,
"model": "mureka-7.5",
"status": "preparing",
"failed_reason": "",
"watermarked": false,
"choices": null
}
}请求示例
bash
curl -X POST "[HOST]/api/v1/music?action=instrumental_generate" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "创作一首宁静的钢琴背景音乐,适合冥想和放松",
"model": "auto"
}'