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
內容與代理工作流程
為影片、Podcast、行銷素材、播放清單，以及程式設計代理發起的任務自動產生原創音樂。
常見問題
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 商用授權，訂閱結束後這些商用權利依然有效。