음악 API 앱, 게임 또는 기기가 고정된 오디오 파일 폴더를 전송하는 대신 서비스에 음악을 요청할 수 있도록 해줍니다. 분위기, 길이 및 형식을 지정하여 요청을 보내면 원하는 트랙이나 원하는 시간 동안 재생되는 스트림을 받을 수 있습니다.
이론상으로는 엔드포인트 두 개와 오디오 플레이어 하나면 충분합니다. 하지만 실제로 첫 번째 테스터가 기차에서 앱을 열자 음악이 시작되는 데 한참 걸리고, 몇 초마다 반복 재생되면서 딸깍거리는 소리가 납니다. 그러자 법무팀에서 사용자가 결과물을 내보낼 수 있는지 묻습니다. 아무도 답할 수 없습니다.
이 가이드는 제품에 음악 기능을 추가하려는 개발자와 제품 팀을 위한 것입니다. 일반적으로 문제가 발생하는 다섯 가지 주요 결정 사항(음악이 나오는 방식, 시작 속도, 반복 방식, 파일 위치, 사용자 편의성)을 순서대로 다룹니다. 예시에서는 다음 내용을 활용합니다. Mubert API앱, 게임 및 서비스를 위한 음악 트랙을 생성하고 스트리밍하는 업체입니다. 하지만 이러한 질문은 모든 제공업체에 적용됩니다.


음악을 연결하세요 API 몇 분 안에
접근 방법은 세 가지가 있으며, 어떤 방법을 선택할지는 코드를 작성하는 사람에 따라 달라집니다.
AI 에이전트가 지금 바로 음악을 수신해야 한다면 MCP 서버에 연결하세요. Claude Code에서는 단 하나의 명령어로 가능합니다.
claude mcp add --transport http mubert-music https://mcp.mubert.com/mcp
Claude Desktop, Cursor 및 기타 클라이언트는 JSON 구성에서 동일한 서버를 사용합니다.
{
"mcpServers": {
"mubert-music": {
"type": "http",
"url": "https://mcp.mubert.com/mcp"
}
}
}
처음 사용 시 클라이언트는 로그인 페이지를 열고, 결제 후 받은 이메일에서 회사 ID와 라이선스 토큰을 붙여넣습니다. 서버는 모든 요청 전에 라이선스를 확인하고, 사용자의 요금제에서 처리할 수 없는 요청은 거부합니다. 따라서 상담원은 처리될 가능성이 없는 요청에 할당량을 낭비하지 않습니다.
상담원이 직접 제품 통합 코드를 작성하도록 하려면 스킬을 설치하세요. 스킬은 REST API를 호출하는 코드를 생성합니다. API:
npx skills add MubertAI/skills
그리고 통합 코드를 직접 작성하는 경우, 나머지는 다음과 같습니다. API 이 가이드의 나머지 부분은 바로 그 내용에 관한 것입니다.
음악이란 무엇인가 API 소리를 전달합니다: 스트림 또는 파일
파일은 완성된 트랙입니다. 파일을 요청하고, 준비가 될 때까지 기다린 후, 링크를 받아 재생합니다. 오프라인에서도 작동하며, 재생할 때마다 동일한 음질을 제공합니다. 외부 자극에 반응하지 않습니다.
스트리밍은 사용자가 멈출 때까지 계속 재생되는 음악입니다. 이는 사용자가 원하는 만큼 오래 지속되는 운동이나 시간을 측정할 수 없는 게임 레벨에 적합합니다. 하지만 스트리밍을 하려면 세션 내내 네트워크 연결이 필요하며, 매 순간이 계획에 차질 없이 소요됩니다.
저희의 기본 원칙은 간단합니다. 사용자의 동작에 따라 음악이 바뀌어야 한다면 스트리밍 방식을 택하세요. 터널, 비행기 안, 또는 약한 Wi-Fi 신호 속에서도 음악이 끊기지 않아야 한다면 파일을 생성하세요. 대부분의 제품은 두 가지 모두 필요합니다. 앱이 온라인 상태일 때는 스트리밍을, 연결이 끊어졌을 때는 저장된 파일을 사용해야 합니다.
이 음악 API REST 호출과 스트림 링크는 서로 다른 호스트에서 실행되며, 스트림은 일반 HTTP 또는 WebRTC 두 가지 방식으로 제공됩니다. 선택적 설정을 생략하면 스트림은 HTTP를 통해 128비트 전송률의 고강도로 시작됩니다.
스트리밍은 끊김 없이 분위기를 바꿀 수도 있습니다. 강도는 낮음, 중간, 높음의 세 단계로 나뉘는데, 이는 동시에 연주되는 악기의 수를 조절하는 것을 의미합니다. 설명서에 따르면 강도 조절은 스트리밍을 중단하지 않고 이루어집니다. 따라서 게임이나 운동 상태에 맞춰 강도 단계를 설정하세요. 그리고 딜레이를 추가하는 것도 좋습니다. 10초 안에 잔잔한 분위기와 강렬한 분위기를 네 번이나 오가는 음악은 차라리 침묵하는 게 낫기 때문입니다.
음악이 얼마나 빨리 시작되어야 할까요?
음악 측정 API 반응 속도는 서버가 요청을 보내는 순간이 아니라 사용자가 탭하는 순간부터 측정됩니다. 사람들이 느끼는 것은 바로 탭하는 순간입니다.
스트리밍의 경우 제품 페이지 에는 두 가지 옵션이 있습니다. 하나는 약 3초 분량의 오디오를 버퍼링하여 즉시 재생을 시작하는 방식이고, 다른 하나는 WebRTC를 사용하여 1초 미만의 지연 시간으로 버튼 클릭이나 게임 이벤트에 즉시 응답해야 하는 음악 재생에 적합합니다.
파일의 경우, 요청하신 음악의 길이는 다음과 같습니다. API 생각보다 훨씬 더 많은 문제가 발생할 수 있습니다. 5초, 6초, 8초, 10초, 15초, 20초, 30초, 40초, 60초, 180초, 240초 또는 300초 길이의 트랙은 한 번의 요청으로 미리 만들어진 트랙 저장소에서 제공될 수 있습니다. 그 외의 길이는 처음부터 새로 작곡해야 하므로 30초짜리 인트로는 빠르게 제작되지만 47초짜리는 더 오래 걸립니다.
그러니까 길이를 반올림하세요. 디자인상 불가능하다면 미리 요청하세요. 정확한 컷에 맞춰 음악을 삽입해야 하는 비디오 편집자가 대표적인 예입니다. 사용자가 타임라인을 열 때 트랙을 요청하고, 내보내기 버튼을 누를 때가 아니라면 편집 과정에서 기다리는 시간을 줄일 수 있습니다.
30초 반복 재생을 요청합니다.
curl -X POST "$API_BASE/public/tracks" \
-H "customer-id: CUSTOMER_ID" \
--header "access-token: ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"playlist_index": "PLAYLIST_INDEX",
"duration": 30,
"format": "mp3",
"mode": "loop",
"intensity": "medium"
}'
$API_BASE 문서에 나와 있는 REST 주소입니다. 재생 목록 인덱스는 잔잔한 앰비언트 음악 채널과 같은 특정 음악 채널을 선택합니다. 한 번의 요청으로 전체 채널 목록을 가져올 수 있으며, 목록은 거의 변경되지 않으므로 서버에 캐시해 두는 것이 좋습니다.
클릭 소리가 나지 않는 반복 음악을 만드세요
앱이나 게임의 배경 음악은 종종 반복됩니다. 만약 음악의 끝부분이 시작 부분과 깔끔하게 연결되지 않으면, 사용자는 반복될 때마다 작은 클릭 소리를 듣게 됩니다. 세 번째 반복쯤 되면 사용자는 이 소리를 알아차리게 되고, 그 후로는 계속해서 신경 쓰이게 됩니다.
문제 해결의 시작은 음악에서 적절한 트랙을 선택하는 것입니다. API설명서에는 네 가지 모드가 나와 있습니다. 트랙 모드는 노래처럼 도입부, 중간 부분, 끝 부분을 만들 수 있습니다. 루프 모드는 트랙을 반복 재생하도록 구성합니다. 징글은 최대 40초 길이의 짧은 완성된 음악이며, 믹스 모드는 DJ처럼 트랙을 순서대로 재생합니다. 끝 부분은 반복되지 않습니다. 따라서 반복되는 부분에는 루프 모드를 사용하세요.
재생 방식도 중요합니다. MP3 파일은 시작과 끝 부분에 몇 밀리초의 무음이 포함되어 있습니다. 팟캐스트에서는 문제가 되지 않지만, 반복 재생 시에는 큰 소음으로 작용할 수 있습니다. 따라서 무손실 음질이 포함된 요금제를 이용한다면 WAV 파일로 요청하거나, MP3 파일에서 해당 무음을 제거하세요. 또한, 일반 타이머가 아닌 차량의 오디오 클럭을 기준으로 반복 재생 일정을 설정하세요. 일반 타이머는 시간이 지남에 따라 오차가 발생할 수 있습니다. 브라우저에서는 오디오 클럭이 다음과 같습니다. AudioContext.currentTime유니티에서는 그렇습니다. AudioSettings.dspTime.
스트림은 서버에서 반복 재생될 수 있습니다. 한 번의 호출로 음악의 최신 부분을 반복 재생하거나 반복 재생을 끌 수 있으며, 현재 재생 시간을 기준으로 하므로 청취자가 실제로 듣고 있는 지점부터 반복 재생이 시작됩니다.
음악을 저장하세요 API 링크가 만료되기 전에 파일을 확인하세요.
모든 트랙의 음악 API 생성된 파일에는 다운로드 링크가 포함되어 있습니다. expired_at 시간. 링크가 유지되는 시간은 라이선스에 따라 다릅니다. 문서 예시에서는 900초(15분)를 사용합니다. 따라서 며칠이 아닌 몇 분 단위로 계획하세요.
규칙은 다음과 같습니다. 트랙이 준비되는 즉시 파일을 자체 저장소에 복사하고 거기에서 제공합니다. 서버는 두 가지 방법으로 트랙 준비 여부를 알 수 있습니다. 지속적으로 요청하거나, 웹훅이 포함된 요금제인 경우, 해당 파일을 서버로 전송하여 준비 상태를 알 수 있습니다. API 트랙 작업이 완료되면 메시지를 보낼 수 있습니다.
또한, 요청하신 정확한 설정(채널, 길이, 모드, 강도, 형식, 비트레이트)으로 파일을 저장하세요. 그러면 동일한 요청이 두 번 발생하더라도 하나의 파일을 재사용하여 두 번의 생성 비용을 지불하지 않아도 됩니다.
화면별 비트레이트를 선택하세요. API 32, 96, 128, 192, 256 및 320kbps를 제공하며, 피트니스 앱의 휴대폰 스피커는 데스크톱 비디오 편집기에 필요한 것과 같은 수준의 성능을 필요로 하지 않습니다.
설명서에는 비용을 절약할 수 있는 또 다른 습관이 나와 있습니다. 바로 라이선스에서 허용하는 내용을 확인하고, 미리 만들어진 음악 라이브러리를 검색한 다음, 필요한 경우에만 새로운 콘텐츠를 생성하는 것입니다. 라이브러리는 템포와 길이별로 필터링할 수 있으며, 제품 페이지에는 약 12,000개의 엄선된 트랙이 있다고 언급되어 있습니다. 모든 요금제에 라이브러리가 포함되는 것은 아니므로 먼저 라이선스를 확인하세요.


음악을 설정하세요 API 백엔드에서 한 번
음악 API 이 시스템은 두 부분으로 나뉩니다. 회사 측에서는 회사 ID와 라이선스 토큰을 사용하여 라이선스와 사용자를 관리합니다. 음악을 재생하는 사용자 측에서는 각 최종 사용자에 대한 고객 ID와 액세스 토큰을 사용합니다.
라이선스 토큰은 서버에만 저장됩니다. 앱 빌드, 게임 또는 기기 펌웨어에는 절대 포함되지 않습니다. 앱 내부에 포함된 모든 요소는 앱에서 제거될 수 있기 때문입니다.
서버는 사용자가 가입할 때 고객 정보를 생성하고 앱에 해당 사용자의 토큰만 제공합니다. 계정이 삭제되면 해당 고객 정보도 함께 삭제해야 합니다. 바로 그러한 기능을 요구하는 요청이 있습니다.
마지막으로, 질문하세요 API 앱이 시작될 때 라이선스 정보를 확인합니다. 답변에는 사용 중인 요금제의 기능, 형식, 모드, 비트 전송률 및 제한 사항이 나열되므로, 앱은 사용 중인 요금제에서 지원하지 않는 버튼을 절대 표시하지 않습니다.
사용자가 음악으로 무엇을 할 수 있는지 결정하세요
여기에는 두 가지 별개의 권리가 있습니다. 하나는 제품 내에서 음악을 재생할 수 있는 귀하의 권리이고, 다른 하나는 사용자가 제품에서 음악을 가져와 비디오를 내보내거나, 릴스를 게시하거나, 팟캐스트 에피소드를 발행할 수 있는 권리입니다. 자세히 설명해 드리겠습니다. 두 층이 어떻게 다른가 별도의 게시물에서 다루겠습니다. 간단히 말해서, 두 번째 권리는 첫 번째 권리에 따라 저절로 주어지는 것이 아닙니다. 악보를 읽으세요. API 구체적인 용어로 설명해 드리겠습니다.
The 라이선스 페이지 두 가지 사항이 명확합니다. 음악의 배포 또는 재판매는 금지되어 있으며, 사용자 제작 콘텐츠에 대해서는 서브라이선스가 가능합니다. API 페이지모든 셀프 서비스 플랜에 서브 라이선싱이 포함되어 있는 것은 아닙니다. 따라서 앱에 내보내기 버튼이 있는 경우, 플랜을 확인하고 버튼을 만들기 전에 관련 내용을 서면으로 확인하세요.
오디오의 출처를 아는 것도 도움이 됩니다. API 실제 음악가들이 업로드한 샘플과 루프를 사용하여 음악을 작곡하고 그에 대한 대가를 받습니다. 용어가 처음이신가요? 서브라이선싱에 대한 초보자 가이드 그것들을 쉬운 말로 설명해 줍니다.
음악 작업을 위한 체크리스트 API 완성
- 셀프 서비스 플랜을 선택하세요. 결제 후 이메일로 계정 정보가 발송됩니다.
- MCP 서버, 스킬 또는 REST를 통해 연결하세요. API.
- 건축을 시작하기 전에 라이선스에서 허용하는 사항을 확인하세요.
- 생성하기 전에 엄선된 12개 이상의 라이브러리를 검색해 보세요.
- 텍스트, 이미지, BPM 또는 장르를 기반으로 15초에서 25분 길이의 음악을 생성합니다.
- WebRTC를 통한 실시간 스트리밍(1초 미만) 또는 버퍼링(즉시 시작)으로 시청할 수 있습니다.
- URL이 만료되기 전에 모든 트랙을 저장하세요.
- 서브라이선스는 플랜에 포함된 경우 사용자에게 추적됩니다.
이 순서대로 하면 음악이 제시간에 시작되고, 클릭 소리 없이 반복 재생되며, 내일도 그대로 있을 겁니다.
시도해 보려면, API 셀프 서비스 플랜으로 시작하며, 결제 후 회사 계정 정보가 이메일로 발송됩니다. 엔드포인트는 다음과 같습니다. 문서계획은 다음과 같습니다. API 페이지.



