在您的应用中集成 AI 音乐：Suno v4.5 30 分钟快速指南

将 AI 生成的音乐添加到产品中，过去意味着需要许可库存音乐库或聘请作曲家。而在 2026 年，您可以调用 Suno v4.5，在大约 60 秒的时间内生成一首包含人声、和声和制作的完整 4 分钟歌曲，成本不到 $0.50。

本文将逐步介绍完整的集成过程，从第一次 curl 调用到基于 webhook 的音频交付到您的应用中。

1. 获取 API 密钥

在 aimarcus.eu/aigenerate/register 注册。注册后可获得 $10 免费额度，足够生成约 20 首 Suno v4.5 歌曲，让您快速上手。

2. 发起生成请求

POST https://aimarcus.eu/aigenerate/api/v1/generate
Authorization: Bearer sk-aig-YOUR_KEY
Content-Type: application/json

{
  "model": "V4_5",
  "prompt": "Upbeat synthwave, driving bass, retro 80s vibe",
  "customMode": false,
  "instrumental": false,
  "callBackUrl": "https://your-app.com/webhooks/suno"
}

响应：

{ "code": 200, "data": { "taskId": "f0147a2e78670ecbce46020219f931a1" } }

3. 定制歌词

设置 customMode: true 并在 prompt 中传递您的歌词。Suno 将处理旋律、编曲、和声及人声演唱。

{
  "model": "V4_5",
  "customMode": true,
  "prompt": "[Verse 1]\nWaking up to a city that never sleeps...",
  "style": "indie pop ballad",
  "title": "Midnight City",
  "callBackUrl": "..."
}

4. 轮询或使用 webhook

两种选项：

• 轮询：每 5 秒调用 GET /api/v1/generate/record-info?taskId=...，直到 state="success"。轮询接口是免费的，不计入您的速率限制或费用。
• Webhook：提供一个 callBackUrl。当歌曲准备好时，我们会将结果 JSON POST 到您的 URL，并在 X-AI-Signature 中附带 HMAC-SHA256 签名。

5. 最终返回结果

成功完成后会返回两个音频 URL（Suno 会生成不同版本）：

{
  "data": {
    "state": "success",
    "response": {
      "sunoData": [
        { "audioUrl": "https://.../track-a.mp3", "duration": 185 },
        { "audioUrl": "https://.../track-b.mp3", "duration": 194 }
      ]
    }
  }
}

两者均为 MP3 格式，44.1 kHz，随时可播放。音频文件将无限期存储在 URL 上，但在生产环境中，建议您下载并重新托管到自己的 CDN 上。

6. 生产环境建议

• 在您的 CDN 上缓存——Suno 的 URL 很快，但当您托管时，您可以控制自己的 SLA。
• 将 taskId 存储在数据库中，与用户请求关联——这使得重试和审计变得简单。
• 如果将此功能开放给终端用户，请在仪表板设置中设定每日消费上限。
• 对于播客风格的语音旁白，请改用专用的 TTS 模型（比 Suno 更快且更便宜）。

以上就是完整流程。同样的模式适用于 Suno v3.5、v4、v4.5 Plus、MusicGen 和 Mureka——只需更改 model 字段即可。