---

# 🎯 서론 – “끝없는 음악, 어떻게 만들까?”

음악 스트리밍 서비스가 급증하면서 무한 음악 스트리밍에 대한 관심도 높아지고 있습니다. 기존에는 미리 녹음된 트랙을 재생하거나, 짧은 루프를 반복하는 방식이 전부였지만, 이제는 AI 기반 텍스트‑투‑뮤직 모델을 활용해 실시간으로 새로운 곡을 생성할 수 있습니다.

하지만 “AI가 만든 음악을 실시간으로 스트리밍하려면 어떻게 해야 할까?” 라는 질문은 초보 개발자에게는 큰 장벽처럼 느껴질 수 있습니다. 이번 글에서는 구글 AI 팀이 공개한 Lyria RealTime을 중심으로, 초보자도 이해하기 쉬운 단계별 구현 방법을 소개합니다.

키워드: Lyria RealTime, 음악 스트리밍, AI 음악 생성

---

# 📦 본론

# 1️⃣ Lyria RealTime이란? – 핵심 개념 정리

| 요소 | 설명 |

|------|------|

| 텍스트‑투‑뮤직 | 사용자가 입력한 텍스트(가사, 분위기, 장르 등)를 기반으로 AI가 멜로디와 편곡을 자동 생성 |

| 실시간 스트리밍 | 생성된 음악을 즉시 오디오 스트림 형태로 전달, 별도 파일 저장 없이 연속 재생 |

| 무한 루프 | 사용자가 종료 명령을 내릴 때까지 새로운 음악을 끊김 없이 제공 |

핵심 포인트: Lyria RealTime은 클라우드 기반 API와 WebSocket을 활용해 초저지연(Latency) 스트리밍을 지원합니다.

---

# 2️⃣ 환경 설정 – 시작은 여기서부터

1. Google Cloud 프로젝트 생성

   • 콘솔에 로그인 → 새 프로젝트 → “Lyria RealTime API” 활성화

2. API 키 발급

   • IAM & Admin > Service Accounts → 새 서비스 계정 → 키(JSON) 다운로드

3. Node.js 개발 환경 (예시)

bash

   npm init -y

   npm install @google-cloud/lyria realtime-websocket

4. 필수 라이브러리

   • ws (WebSocket 클라이언트)

   • ffmpeg (오디오 인코딩)

Tip: 로컬에서 테스트할 때는 ngrok을 이용해 임시 HTTPS 엔드포인트를 만들면 WebSocket 연결이 더 원활합니다.

---

# 3️⃣ 코드 흐름 – “텍스트 → 음악 → 스트리밍” 단계별 구현

# 3‑1. 텍스트 입력 받기

js

const readline = require('readline');

const rl = readline.createInterface({

  input: process.stdin,

  output: process.stdout

});

rl.question('원하는 분위기와 장르를 입력하세요: ', (prompt) => {

  startStreaming(prompt);

  rl.close();

});

# 3‑2. Lyria RealTime API 호출

js

const {LyriaClient} = require('@google-cloud/lyria');

const client = new LyriaClient({keyFilename: 'service-account.json'});

async function startStreaming(prompt) {

  const stream = await client.createRealtimeStream({

    prompt,

    voice: 'korean_female',   // 한국어 음성 모델

    format: 'audio/webm'      // 웹 스트리밍 최적 포맷

  });

  // WebSocket 연결

  const ws = new WebSocket(stream.websocketUrl);

  ws.on('open', () => console.log('스트리밍 시작!'));

  ws.on('message', (data) => playAudio(data));

}

# 3‑3. 오디오 재생 (브라우저 혹은 Node.js)

js

const speaker = require('speaker');

function playAudio(chunk) {

  const audio = new Speaker({

    channels: 2,

    bitDepth: 16,

    sampleRate: 48000

  });

  audio.write(chunk);

}

핵심: WebSocket을 통해 전달되는 오디오 청크를 바로 Speaker 모듈에 파이프라인 하면, 지연시간 200ms 이하의 무한 스트리밍이 구현됩니다.

---

# 4️⃣ 고급 기능 – 맞춤형 무한 플레이리스트 만들기

| 기능 | 구현 아이디어 |

|------|----------------|

| 다이나믹 프롬프트 | 사용자가 청취 중에 “더 빠르게”, “잔잔하게” 등 명령을 입력하면 프롬프트를 실시간 업데이트 |

| 다중 트랙 믹싱 | 두 개 이상의 Lyria 스트림을 병합해 새로운 하이브리드 트랙 생성 |

| 사용자 피드백 루프 | 청취 종료 시 “좋아요/별로예요”를 저장해 AI가 다음 곡에 반영하도록 학습 |

예시 코드 (다이나믹 프롬프트 업데이트)

js

ws.send(JSON.stringify({type: 'update_prompt', prompt: '더 빠른 템포'}));

---

# 5️⃣ 배포와 운영 – 실제 서비스에 적용하기

1. Docker 이미지 만들기

dockerfile

   FROM node:18-alpine

   WORKDIR /app

   COPY . .

   RUN npm ci

   CMD ['node', 'index.js']

2. Kubernetes에 배포 (스케일링 고려)

   • replicas: 3 로 설정해 부하 분산

   • HorizontalPodAutoscaler 로 트래픽에 따라 자동 확장

3. 모니터링

   • Stackdriver 로그와 Prometheus 메트릭을 활용해 스트리밍 지연시간, 오류율을 실시간 감시

운영 팁: 무료 티어 한도(월 1000시간 스트리밍)를 초과하면 비용이 급증하니, 캐시 레이어(예: Redis)로 동일 프롬프트에 대한 재생을 재활용하면 비용 절감에 도움이 됩니다.

---

# 🚀 결론 – 지금 바로 무한 음악 스트리밍을 시작하세요!

Lyria RealTime은 텍스트‑투‑뮤직과 실시간 스트리밍을 한 번에 제공하는 강력한 도구입니다. 위에서 소개한 환경 설정, 코드 흐름, 고급 기능, 배포 전략을 차근차근 따라 하면, 초보자도 금방 무한 음악 스트리밍 서비스를 구축할 수 있습니다.

• 시작하기: 오늘 바로 Google Cloud 콘솔에서 Lyria RealTime API를 활성화하고, 샘플 코드를 실행해 보세요.

• 공유하기: 구현 과정에서 겪은 팁이나 문제점은 댓글이나 SNS에 공유해 다른 개발자와 지식을 나눠보세요.

행동 유도: 지금 바로 Lyria RealTime를 체험하고, 당신만의 무한 음악 플레이리스트를 만들어 보세요! 🎧

---

본 글은 2025년 12월 기준 최신 정보를 바탕으로 작성되었습니다. API 사양은 업데이트될 수 있으니, 공식 문서를 항상 확인하세요.