Communitygithub.com

ElevenLabs 음성 해설 생성

ElevenLabs AI를 사용하여 전문적인 음성 해설을 생성합니다. 비디오, 오디오 내레이션 또는 텍스트-음성 변환 콘텐츠가 필요할 때 사용합니다. 내레이터, 영업사원, 전문가 등 다양한 캐릭터 프리셋을 지원하며 단일 장면 재생성으로 세부 조정이 가능합니다.

ElevenLabs 음성 해설 생성란 무엇인가요?

이 스킬은 ElevenLabs API를 사용하여 Remotion 비디오 프로젝트를 위한 고품질 AI 음성 해설을 생성합니다. 사용자는 텍스트를 입력하거나 장면 기반 JSON 파일을 제공하여 여러 오디오 클립을 일괄 생성할 수 있습니다. '내레이터', '전문가', '드라마틱' 등 다양한 캐릭터 프리셋을 지원하여 문맥에 맞는 자연스러운 전달이 가능합니다. 생성된 오디오는 자동으로 검증되어 예상 길이, 침묵 구간, 말하기 속도를 확인하며, 단일 장면 재생성을 통해 전체 프로젝트를 다시 생성하지 않고도 세부 조정이 가능합니다. 또한 MP4 비디오에 썸네일을 삽입하여 소셜 미디어 플랫폼에서 사용자 지정 썸네일을 표시할 수 있습니다. 이 스킬은 Claude Code, Cursor, Codex와 같은 AI 에이전트 도구에서 활용할 수 있도록 설계되었으며, 명령줄 인터페이스를 통해 간편하게 사용할 수 있습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/delorenj/skills/tree/HEAD/elevenlabs-remotion

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

ElevenLabs 음성 해설 생성은(는) 무엇을 하나요?

ElevenLabs API를 사용하여 Remotion 비디오를 위한 전문적인 AI 음성 해설을 생성합니다.

전제 조건

  • .env.local 파일에 ELEVEN_API_KEY가 설정되어 있어야 합니다.

빠른 시작

# 텍스트로 음성 해설 생성
node ~/.agents/skills/elevenlabs-remotion/generate.js --text "음성으로 변환할 텍스트" --output public/audio/voiceover.mp3

# 내레이터 스타일로 생성 (더 자연스럽게)
node ~/.agents/skills/elevenlabs-remotion/generate.js --text "내레이션할 텍스트" --character narrator --output voiceover.mp3

# 장면 요청 연결(Stitching)을 사용한 장면 생성
node ~/.agents/skills/elevenlabs-remotion/generate.js --scenes remotion/scenes.json --output-dir public/audio/project/

# 단일 장면 재생성
node ~/.agents/skills/elevenlabs-remotion/generate.js --scenes scenes.json --scene scene2 --new-text "업데이트된 텍스트"

# 사용 가능한 음성 및 캐릭터 프리셋 목록 보기
node ~/.agents/skills/elevenlabs-remotion/generate.js --list-voices
node ~/.agents/skills/elevenlabs-remotion/generate.js --list-characters

캐릭터 프리셋

화면 텍스트를 그대로 읽는 대신 캐릭터 프리셋을 사용하여 더 자연스러운 음성 해설을 만드세요.

캐릭터설명최적 용도
literal텍스트를 있는 그대로 읽음화면 텍스트, 인용문
narrator전문적인 스토리텔러, 부드럽고 매력적설명 영상, 다큐멘터리
salesperson열정적이고 설득력 있으며 활기참마케팅, 광고
expert권위 있고 자신감 있으며 박식함법률 콘텐츠, 튜토리얼
conversational캐주얼하고 친근하며 자연스러움소셜 미디어, 캐주얼 콘텐츠
dramatic강렬하고 감정적이며 영향력 있음후크, 문제 진술
calm부드럽고 안심시키며 온화함신뢰 구축, 결론
# 전역적으로 내레이터 스타일 사용
node ~/.agents/skills/elevenlabs-remotion/generate.js --scenes scenes.json --character narrator --output-dir public/audio/

# 또는 scenes.json에서 장면별로 설정
{
  "scenes": [
    { "id": "scene1", "text": "문제 진술", "character": "dramatic" },
    { "id": "scene2", "text": "해결책", "character": "calm" }
  ]
}

장면 기반 생성 및 요청 연결(Stitching)

ElevenLabs 요청 연결을 사용하여 일관된 운율로 여러 장면을 생성합니다.

scenes.json 형식

{
  "name": "product-demo",
  "voice": "George",
  "character": "narrator",
  "scenes": [
    {
      "id": "scene1",
      "text": "Generic text-to-speech sounds robotic. Your brand deserves better.",
      "duration": 4.5,
      "character": "dramatic"
    },
    {
      "id": "scene2",
      "text": "With voice cloning, you can use your own voice for unlimited content.",
      "duration": 5.5
    },
    {
      "id": "scene3",
      "text": "Record a short sample. Clone it. Create professional voiceovers in minutes.",
      "duration": 6,
      "delay": 0.3
    }
  ]
}

모든 장면 생성

node ~/.agents/skills/elevenlabs-remotion/generate.js \
  --scenes remotion/product-demo-scenes.json \
  --output-dir public/audio/product-demo/

이 명령은 다음 파일을 생성합니다.

  • product-demo-scene1.mp3 ~ sceneN.mp3
  • product-demo-combined.mp3 (모든 장면이 연결된 파일)
  • product-demo-info.json (길이 정보가 포함된 메타데이터)

단일 장면 재생성

장면이 너무 일찍 시작되거나, 타이밍이 잘못되었거나, 다른 텍스트가 필요한 경우:

# 새로운 텍스트로 scene2 재생성
node ~/.agents/skills/elevenlabs-remotion/generate.js \
  --scenes remotion/scenes.json \
  --scene scene2 \
  --new-text "업데이트된 장면 2 텍스트" \
  --output-dir public/audio/project/

# 다른 캐릭터로 scene3 재생성
node ~/.agents/skills/elevenlabs-remotion/generate.js \
  --scenes remotion/scenes.json \
  --scene scene3 \
  --character salesperson \
  --output-dir public/audio/project/

# 그냥 재생성 (동일한 텍스트, 동일한 캐릭터)
node ~/.agents/skills/elevenlabs-remotion/generate.js \
  --scenes remotion/scenes.json \
  --scene scene1 \
  --output-dir public/audio/project/

# MP4 비디오에 썸네일 삽입
node ~/.agents/skills/elevenlabs-remotion/generate.js \
  --embed-thumbnail public/videos/my-video.mp4 \
  --thumbnail public/videos/my-thumbnail.png \
  --output public/videos/my-video-with-thumb.mp4

이 도구는 자동으로:

  • 이전 장면의 요청 연결을 사용하여 일관된 운율 유지
  • 새로운 메타데이터로 info.json 파일 업데이트
  • --new-text가 제공되면 scenes.json 업데이트

썸네일 삽입

MP4 비디오에 썸네일 이미지를 삽입하여 Twitter, YouTube 및 비디오 플레이어가 첫 번째 프레임 대신 사용자 지정 썸네일을 표시하도록 합니다.

비디오에 썸네일 삽입

# 기본 사용법 - video-thumb.mp4로 출력
node ~/.agents/skills/elevenlabs-remotion/generate.js \
  --embed-thumbnail public/videos/promo.mp4 \
  --thumbnail public/videos/thumbnail.png

# 사용자 지정 출력 경로
node ~/.agents/skills/elevenlabs-remotion/generate.js \
  --embed-thumbnail public/videos/promo.mp4 \
  --thumbnail public/videos/thumbnail.png \
  --output public/videos/promo-final.mp4

Remotion과 함께 사용하는 워크플로우

# 1. 비디오 렌더링
npx remotion render MyVideo public/videos/my-video.mp4

# 2. 썸네일 렌더링 (Still 구성 사용)
npx remotion still MyVideoThumbnail public/videos/my-thumbnail.png

# 3. 썸네일 삽입
node ~/.agents/skills/elevenlabs-remotion/generate.js \
  --embed-thumbnail public/videos/my-video.mp4 \
  --thumbnail public/videos/my-thumbnail.png \
  --output public/videos/my-video-final.mp4

지원되는 형식

  • 비디오: MP4 (H.264/H.265)
  • 썸네일: PNG, JPG, JPEG

삽입은 ffmpeg의 -disposition:v:1 attached_pic 플래그를 사용하여 썸네일을 첨부 사진으로 설정하며, 대부분의 비디오 플레이어와 플랫폼에서 인식합니다.

타이밍 검증

이 스킬은 생성 후 ffprobe를 사용하여 자동으로 타이밍을 검증합니다.

검사 항목

검사임계값설명
길이 불일치>15%실제 길이가 예상 길이와 다른 경우 경고
앞부분 침묵>200ms오디오가 늦게 시작됨 (음성 해설 지연)
뒷부분 침묵>500ms끝에 불필요한 침묵
말하기 속도2-4.5 단어/초최적 약 3 단어/초

기존 오디오 검증

# 프로젝트의 모든 장면 검증
node ~/.agents/skills/elevenlabs-remotion/generate.js --validate public/audio/product-demo/

출력 예시:

🔍 product-demo 검증 중 (6개 장면)

❌ scene1: 3.00초 (예상: 4.5초)
   ❌ 오디오가 예상보다 1.50초 짧습니다.
   👍 8단어 @ 3.1 단어/초
⚠️ scene2: 6.35초 (예상: 5.5초)
   ⚠️ 앞부분 침묵: 235ms (늦게 시작될 수 있음)
   🐢 10단어 @ 1.8 단어/초
✅ scene4: 4.36초 (예상: 4초)
   👍 9단어 @ 2.3 단어/초

📊 총 길이: 30.80초 (예상: 30.00초)

업데이트된 info.json

검증 후 info.json에 실제 측정값이 포함됩니다.

{
  "scenes": [
    {
      "id": "scene1",
      "duration": 4.5,
      "actualDuration": 3.0,
      "leadingSilence": 0.05,
      "wordsPerSecond": 3.1
    }
  ]
}

정확한 동기화를 위해 Remotion 구성에서 actualDuration을 사용하세요.

옵션

옵션설명기본값
--text, -t음성으로 변환할 텍스트필수 (또는 --file/--scenes)
--file, -f파일에서 텍스트 읽기-
--output, -o출력 파일 경로output.mp3
--output-dir장면 출력 디렉토리public/audio
--voice, -v음성 이름 또는 IDGeorge
--model, -m모델 IDeleven_multilingual_v2
--character, -c캐릭터 프리셋literal
--scenes장면이 포함된 JSON 파일-
--scene재생성할 단일 장면 ID-
--new-text장면 재생성을 위한 새 텍스트-
--validate기존 오디오 디렉토리 검증-
--skip-validation자동 검증 건너뛰기false
--embed-thumbnail썸네일을 삽입할 비디오 파일-
--thumbnail썸네일 이미지 파일 (PNG/JPG)-
--stability음성 안정성 (0-1)캐릭터에 따라 다름
--similarity음성 유사성 (0-1)캐릭터에 따라 다름
--style스타일 강조 (0-1)캐릭터에 따라 다름
--no-combined결합 파일 생성 안 함false

추천 음성

음성스타일최적 용도
George따뜻하고 매혹적인 영국식내레이션, 설명 영상
Antoni전문적이고 따뜻함법률 콘텐츠, 튜토리얼
Arnold권위 있고 깊음기업, 진지한 주제
Josh친근하고 대화체마케팅, 캐주얼 콘텐츠

Remotion과 통합

장면 음성 해설을 생성한 후 구성에서 사용하세요.

import { Audio, Sequence, staticFile } from "remotion";

// 정확한 동기화를 위해 개별 장면 오디오 파일 사용
const SCENE_DURATIONS = {
  scene1: 4.5,  // info.json에서 가져온 값
  scene2: 5.5,
  scene3: 8.0,
};

export const VideoWithVoiceover: React.FC = () => {
  const { fps } = useVideoConfig();

  const scene1Frames = Math.round(SCENE_DURATIONS.scene1 * fps);
  const scene2Frames = Math.round(SCENE_DURATIONS.scene2 * fps);

  return (
    <>
      <Sequence from={0} durationInFrames={scene1Frames}>
        <Audio src={staticFile("audio/project/project-scene1.mp3")} />
        <Scene1Visual />
      </Sequence>

      <Sequence from={scene1Frames} durationInFrames={scene2Frames}>
        <Audio src={staticFile("audio/project/project-scene2.mp3")} />
        <Scene2Visual />
      </Sequence>
    </>
  );
};

최상의 결과를 위한 팁

  1. 캐릭터 프리셋 사용: 화면 텍스트를 그대로 읽지 말고 narrator 또는 expert를 사용하여 자연스러운 흐름을 만드세요.
  2. 구두점이 중요: 마침표는 멈춤, 쉼표는 짧은 휴식에 사용하세요.
  3. 숫자: 자연스러운 발음을 위해 숫자를 풀어서 쓰세요("500" 대신 "오백").
  4. 약어: 전체 단어를 쓰세요("24시간" 대신 "이십사 시간").
  5. 장면별: 다른 장면에 다른 캐릭터를 사용할 수 있습니다(극적인 도입, 차분한 CTA).
  6. 세부 조정: --scene을 사용하여 전체를 다시 생성하지 않고 개별 장면을 재생성하세요.
  7. 요청 연결: 모든 장면에서 음성 일관성을 유지합니다.

워크플로우 예시

# 1. 스크립트로 scenes.json 생성
# 2. 내레이터 스타일로 모든 장면 생성
node ~/.agents/skills/elevenlabs-remotion/generate.js \
  --scenes remotion/my-video-scenes.json \
  --character narrator \
  --output-dir public/audio/my-video/

# 3. Remotion에서 미리보기, scene2가 너무 일찍 시작되는 것을 확인
# 4. 업데이트된 텍스트로 scene2만 재생성
node ~/.agents/skills/elevenlabs-remotion/generate.js \
  --scenes remotion/my-video-scenes.json \
  --scene scene2 \
  --new-text "비주얼 타이밍에 맞춰 약간 더 긴 텍스트" \
  --output-dir public/audio/my-video/

# 5. info.json의 새 길이로 비디오 구성 업데이트
# 6. 타이밍이 완벽해질 때까지 반복

Individual skills in this repo

This repo contains 14 individual skills — each has its own dedicated page.

delorenj/skills

Plan and generate terminal ASCII animations/screensaver-style output (FPS, refresh rules, loop policy, low-flicker guidance), with a static poster frame and an optional local demo script.

delorenj/skills

ASCII video: convert video/audio to colored ASCII MP4/GIF.

delorenj/skills

Plan, build and quality-check a premium short commercial for a real business (roofing, property, ecommerce, B2B software) using AI-generated footage, code-built motion (HTML/GSAP), selective Three.js and an independent-critic "Gauntlet" loop. Use when asked to make a launch-style / SaaS-style video, business ad, explainer, sample reel or pitch video, or to review and improve one. Encodes motion principles distilled from 28 professional launch films, a quality bar, audio rules and a business-offer playbook.

delorenj/skills

CSS animation adapter patterns for HyperFrames. Use when authoring CSS keyframes, animation-delay based timing, animation-fill-mode, animation-play-state, or CSS-only motion that HyperFrames must seek deterministically during preview and rendering.

delorenj/skills

HyperFrames CLI dev loop — `npx hyperframes` for scaffolding (init), validation (lint, inspect), preview, render, and environment troubleshooting (doctor, browser, info, upgrade). Use when running any of these commands or troubleshooting the HyperFrames build/render environment. For asset preprocessing commands (`tts`, `transcribe`, `remove-background`), invoke the `hyperframes-media` skill instead.

delorenj/skills

Asset preprocessing for HyperFrames compositions — text-to-speech narration (Kokoro), audio/video transcription (Whisper), and background removal for transparent overlays (u2net). Use when generating voiceover from text, transcribing speech for captions, removing the background from a video or image to use as a transparent overlay, choosing a TTS voice or whisper model, or chaining these (TTS → transcribe → captions). Each command downloads its own model on first run.

delorenj/skills

Install and wire registry blocks and components into HyperFrames compositions. Use when running hyperframes add, installing a block or component, wiring an installed item into index.html, or working with hyperframes.json. Covers the add command, install locations, block sub-composition wiring, component snippet merging, and registry discovery.

delorenj/skills

Create video compositions, animations, title cards, overlays, captions, voiceovers, audio-reactive visuals, and scene transitions in HyperFrames HTML. Use when asked to build any HTML-based video content, add captions or subtitles synced to audio, generate text-to-speech narration, create audio-reactive animation (beat sync, glow, pulse driven by music), add animated text highlighting (marker sweeps, hand-drawn circles, burst lines, scribble, sketchout), or add transitions between scenes (crossfades, wipes, reveals, shader transitions). Covers composition authoring, timing, media, and the full video production workflow. For dev-loop CLI commands (init, lint, inspect, preview, render) see the hyperframes-cli skill; for asset preprocessing commands (tts, transcribe, remove-background) see the hyperframes-media skill.

delorenj/skills

Manim CE animations: 3Blue1Brown math/algo videos.

delorenj/skills

Join a Google Meet or Zoom call as a video meeting agent via PikaStreaming. Trigger: user drops a Google Meet or Zoom link, or asks to join a meeting.

delorenj/skills

Translate an existing Remotion (React-based) video composition into a HyperFrames HTML composition. Use ONLY when the user explicitly asks to port, convert, migrate, translate, or rewrite a Remotion composition as HyperFrames (e.g. "port my Remotion project to HyperFrames"). Do NOT use when (a) authoring a NEW HyperFrames composition (even if A/B-testing a Remotion video); (b) Remotion is mentioned in passing; (c) Remotion code is shared as reference, not for translation; (d) the user wants "the same video as my Remotion one" without explicitly asking to migrate the source — treat as a fresh HyperFrames build. When in doubt, default to the `hyperframes` skill. Detects unsupported patterns (useState, useEffect side effects, async calculateMetadata, third-party React component libraries, `@remotion/lambda`) and recommends the runtime interop escape hatch instead of a lossy translation.

delorenj/skills

Generate speech using the self-hosted voxxy (vox) TTS service at https://vox.delo.sh. Use when the user asks to speak, say, narrate, synthesize speech, clone a voice, create a voice, add or register a voice, pipe TTS, or control voice qualities by description (e.g. "a young woman with a cheerful voice"). Handles HTTP API usage, voice profile management, description-based voice design, cloning, MCP registration, and integration patterns for new platforms.

delorenj/skills

Capture a website and create a HyperFrames video from it. Use when: (1) a user provides a URL and wants a video, (2) someone says "capture this site", "turn this into a video", "make a promo from my site", (3) the user wants a social ad, product tour, or any video based on an existing website, (4) the user shares a link and asks for any kind of video content. Even if the user just pastes a URL — this is the skill to use.

delorenj/skills

YouTube transcripts to summaries, threads, blogs.

관련 스킬