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/generationsAPI 키 만들기개발자와 에이전트를 위해
작업 흐름에 맞는 AI 음악 생성 API
요청 한 번이면 호스팅된 트랙까지. 직접 코드를 짜도 되고, SDK를 써도 되고, 이미 쓰고 있는 코딩 에이전트에 맡겨도 돼요.
요청 한 번으로 완성된 트랙 생성
- 원하는 스타일과 제목을 설명하세요
- 연주곡 모드를 고르거나 직접 쓴 가사를 넣으세요
- 호스팅된 오디오와 메타데이터가 담긴 완성 트랙을 받으세요
Cursor, Claude Code, Codex 연결
- 공식 lacuna-mcp 서버를 npm에서 바로 실행하세요
- 코딩 에이전트의 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 토큰으로 보내세요. 키 교체와 폐기도 같은 대시보드에서 할 수 있어요.
네. 공식 lacuna-mcp 서버를 설치하고 에이전트의 MCP 설정에 Lacuna API 키를 넣은 다음 자연어로 트랙을 요청하세요. 같은 도구가 Cursor, Claude Code, Codex를 비롯한 다른 MCP 호환 클라이언트에서도 동작해요.
Music API는 Pro와 Ultra 플랜에서 쓸 수 있어요. 사용량은 크레딧 기반이고, 플랜별 최신 내용은 요금 페이지에 있어요.
생성 엔드포인트는 API 키당 분당 60회 요청까지예요. 동시 생성 기본 한도는 Pro 10개, Ultra 20개 작업이고, 계정별로 다른 값이 적용될 수도 있어요.
크레딧은 작업을 만들 때 차감되고, 생성이 실패하면 자동으로 환불돼요. 타입이 지정된 오류와 webhook 이벤트로 실패를 애플리케이션에서 명확하게 처리할 수 있어요.
Pro나 Ultra 구독이 유효한 동안 만든 곡은 Lacuna 상업용 라이선스가 적용되고, 그 상업적 권리는 구독이 끝난 뒤에도 유지돼요.