01
音乐应用与游戏
让用户在你的产品里就能生成原创曲目、为原型配乐、为互动场景创作音乐。
cURL 快速上手
终端
curl https://www.lacuna.fm/api/v1/music/generations \
-H "Authorization: Bearer $LACUNA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"style": "lofi hip hop, mellow piano, 70 bpm",
"title": "Late Night Study",
"instrumental": true,
"model": "aether"
}'POST /api/v1/music/generations创建 API 密钥为开发者与 AI 智能体而建
贴合你工作流的 AI 音乐生成 API
一次请求就能拿到托管音轨：直接写代码、用 SDK，或者交给你已经在用的编程智能体。
一次请求，生成完整曲目
- 描述你想要的风格和标题
- 选择纯音乐模式，或提供你自己的歌词
- 拿到完整曲目，含托管音频与元数据
接入 Cursor、Claude Code 和 Codex
- 直接从 npm 运行官方 lacuna-mcp 服务器
- 在编程智能体的 MCP 配置里填一个 API 密钥
- 用自然语言提出需求，直接拿到托管曲目
REST、TypeScript、CLI 或 MCP 任选
- 用任意后端语言调用 REST API
- 在 Node.js 18+ 上使用带类型的 create、retrieve 与 waitFor 方法
- 用官方 SDK 校验 webhook 签名
围绕清晰的异步生命周期开发
- 创建任务后轮询状态，或调用 waitFor
- 接收带签名的 job.completed 与 job.failed webhook
- 生成失败时自动退回积分
选择接入方式
从最适合你技术栈的接口起步
同一套 Lacuna Music API，可以通过直接 HTTP 调用、带类型的 SDK、命令行工具，以及面向 Cursor、Claude Code、Codex 等编程智能体的 MCP 服务器使用。
使用场景
两类工作流，同一套生成 API
把生成好的完整曲目用在交互式产品里，或者让音乐制作在内容与智能体工作流背后自动跑起来。
02
内容与智能体工作流
为视频、播客、营销素材、歌单，以及编程智能体发起的任务自动生成原创音乐。
常见问题
AI 音乐 API 常见问题
关于访问权限、生成、计费与接入的现行说明。
它能生成完整的纯音乐曲目或带人声的歌曲。每次请求都要提供标题和风格描述；生成人声时还需要由你的应用提供歌词。
不会。生成人声时，歌词由你的应用提供。如果需要先写词，可以用 Lacuna 单独的歌词工具。
不是。创建生成任务返回的是一个异步任务。你可以轮询它的状态、使用 TypeScript SDK 的 waitFor 辅助方法，或者订阅带签名的 job.completed 和 job.failed webhook。
在 Lacuna 个人资料页创建 API 密钥，把它放在密钥管理服务里，以 Bearer token 的形式发送。密钥可以在同一处轮换或撤销。
可以。安装官方的 lacuna-mcp 服务器，把 Lacuna API 密钥填进智能体的 MCP 配置，然后用自然语言提需求就行。同一套工具在 Cursor、Claude Code、Codex 以及其他兼容 MCP 的客户端里都能用。
Music API 面向 Pro 和 Ultra 计划开放，按积分计费；各计划的当前细节见定价页面。
创建端点对每个 API 密钥限流每分钟 60 次请求。默认并发生成上限为 Pro 10 个任务、Ultra 20 个任务；个别账户可能有单独设置。
积分在任务创建时扣除，生成失败会自动退回。带类型的错误与 webhook 事件让你的应用可以显式处理失败情况。
在 Pro 或 Ultra 订阅有效期内生成的歌曲适用 Lacuna 商用授权，订阅到期后这些商用权利依然有效。