Skip to content

生成纯音乐

Mureka 的纯音乐生成功能专注于创作无歌词的器乐作品,适合背景音乐、配乐、环境音乐等场景。支持多种音乐风格和复杂度设置。

接口信息

  • 方法: POST
  • 路径: /api/v1/music?action=instrumental_generate

认证方式

  • 类型: HTTP Bearer 认证
  • 说明: 需在请求头中携带 Authorization: Bearer YOUR_API_KEY

请求体

json
{
  "prompt": "创作一首宁静的钢琴背景音乐,适合冥想和放松",
  "model": "auto"
}

Parameter Description

FieldTypeRequiredDescription
modelstringNo要使用的模型。使用 auto 选择常规模型的最新版。可选:auto,mureka-6,mureka-7.5
nintNo每次请求生成的纯音乐数量,最大值为3,缺省为2. 注意会根据数量计费。
promptstringNo通过输入提示词控制纯音乐的生成,最大1024个字符。选择此选项时,其他控制选项(instrumental_id)不能选择。
instrumental_idstringNo通过参考音乐控制纯音乐的生成,由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"
  }'