第一个生成请求怎么发：注册、密钥、认证与调用示例

按官方快速入门文档整理，五步发出你的第一个音乐生成请求。

第一步：注册账户

在官方 API 平台点击登录按钮完成注册。开发者账户与普通创作账户相互独立，请认准开发者平台入口。

第二步：创建 API 密钥

注册后在平台的 API Keys 标签页查看与管理密钥。官方特别强调：

• API 密钥是机密信息，不要与他人共享；
• 不要在任何客户端代码（浏览器、App）中暴露密钥——密钥只该出现在你自己的服务端。

第三步：认证方式

所有请求需在 HTTP 头中携带密钥，格式为标准的 Bearer 认证：

Authorization: Bearer YOUR_MUREKA_API_KEY

API 服务器地址以官方开发者文档公布的为准（国际站与国内站各提供对应域名）。

第四步：发出歌曲生成请求

以生成任务接口为例，用环境变量保管密钥的写法：

curl "$MUREKA_API_BASE/v1/song/generate" \
  -H "Authorization: Bearer $MUREKA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "lyrics": "[Verse]\n在暴风雨的夜晚，我独自徘徊\n迷失在雨中，感觉像是被抛弃",
    "model": "auto",
    "prompt": "r&b, slow, passionate, male vocal"
  }'

请求会创建一个异步生成任务，成功时返回类似如下的响应：

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

• id 是任务编号，用于后续查询结果；
• status 表示任务状态，生成完成后取回音频；
• model 显示实际使用的模型版本。

第五步：排错

• 请求失败时返回 400 到 600 之间的 HTTP 状态码与错误信息，例如鉴权失败会提示 Invalid Authentication；
• 官方建议在生产环境记录响应中的 trace_id——联系支持团队排查时，它能帮对方快速定位请求链路；
• 完整错误码清单见官方开发者文档的错误代码页。

更全面的接口参数与回调机制，以官方开发者文档为准，能力总览见开放 API 能做什么。