Skip to content

快速入门

欢迎使用 Mureka API!借助Mureka API,企业和开发者可以利用先进的音乐大模型轻松生成高质量且富有创意的音乐。

创建账户

请点击 Mureka 平台 上的“登录”按钮注册一个账户。

创建API密钥

注册后,您可以在平台导航到“API Keys”标签页,查看和管理您的API密钥。请记住,您的API密钥是机密信息!不要与他人共享,也不要在任何客户端代码(浏览器、应用程序)中暴露。

服务器

https://api.mureka.cn

认证

Mureka API 使用API密钥进行认证。所有API请求都应在 Authorization HTTP 头中包含您的API密钥,格式如下:

shell
Authorization: Bearer MUREKA_API_KEY

发送请求

您可以将以下命令粘贴到终端中以运行您的第一个API请求。请确保将 $MUREKA_API_KEY 替换为您的API密钥。

shell
curl https://api.mureka.cn/v1/song/generate \
  -H "Authorization: Bearer $MUREKA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "lyrics": "[Verse]\n在暴风雨的夜晚,我独自徘徊\n迷失在雨中,感觉像是被抛弃\n你的回忆,它们在我眼前闪烁\n希望有那么一刻,能找到一些幸福",
    "model": "auto",
    "prompt": "r&b, slow, passionate, male vocal"
  }'

此请求将生成一个音乐创作任务。您应该会收到类似以下内容的响应:

json
{
  "id": "1436211",
  "created_at": 1677610602,
  "model": "mureka-6",
  "status": "preparing",
  "trace_id": "1e94aba5a2de4cc4bff54a2813c8d36c"
}

当请求失败时,将返回400到600间的HTTP状态码,以及类似以下内容的错误消息:

json
{
  "error": {
    "message": "Invalid Authentication"
  },
  "trace_id": "1e94aba5a2de4cc4bff54a2813c8d36c"
}

故障排除

除了从API响应中返回的 错误代码 外,您还可以检查API响应中的 trace_id 以跟踪请求并用于故障排除。我们建议在生产部署中记录 trace_id,以便在需要时与我们的支持团队进行高效的故障排除。