Communitygithub.com

ElevenLabs 音声生成

ElevenLabs AIを使用してプロフェッショナルなナレーションを生成します。動画のナレーション、音声ナレーション、テキスト読み上げコンテンツの作成が必要な場合に使用します。自然な配信のために、複数の音声とキャラクタープリセット(ナレーター、営業担当、専門家)をサポートしています。個別シーンの再生成による微調整も可能です。

ElevenLabs 音声生成 とは?

このスキルは、ElevenLabs APIを利用して高品質なAIナレーションを生成するためのツールです。特にRemotion動画との連携を想定した設計で、テキストから直接MP3音声ファイルを生成できます。複数のキャラクタープリセット(ナレーター、営業担当、専門家など)を提供し、目的に合わせた自然な配信スタイルを選択できます。シーンベースの生成機能では、JSON形式で複数のシーンを定義し、一括で音声ファイルを生成。個別シーンの再生成にも対応しており、タイミングの調整が容易です。また、生成後のタイミング検証(発話速度、無音時間など)も自動で実施。MP4動画へのサムネイル埋め込み機能も備えています。

対応~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

# リクエストスティッチングでシーンを生成
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" }
  ]
}

シーンベース生成(リクエストスティッチング)

ElevenLabsのリクエストスティッチングを使用して、一貫したプロソディで複数のシーンを生成します。

scenes.json の形式

{
  "name": "product-demo",
  "voice": "George",
  "character": "narrator",
  "scenes": [
    {
      "id": "scene1",
      "text": "一般的なテキスト読み上げはロボットのように聞こえます。あなたのブランドにはもっとふさわしいものがあります。",
      "duration": 4.5,
      "character": "dramatic"
    },
    {
      "id": "scene2",
      "text": "音声クローンを使用すれば、自分の声で無制限のコンテンツを作成できます。",
      "duration": 5.5
    },
    {
      "id": "scene3",
      "text": "短いサンプルを録音し、クローンし、数分でプロフェッショナルなナレーションを作成します。",
      "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(メタデータ:各シーンの長さなど)

単一シーンの再生成

シーンの開始が早すぎる、タイミングが合わない、テキストを変更したい場合:

# シーン2を新しいテキストで再生成
node ~/.agents/skills/elevenlabs-remotion/generate.js \
  --scenes remotion/scenes.json \
  --scene scene2 \
  --new-text "更新されたシーン2のテキスト" \
  --output-dir public/audio/project/

# シーン3を別のキャラクターで再生成
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. 省略形: 完全な単語で書く(「24h」ではなく「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.

関連スキル