菜单
Turn scripts into publishable voiceovers with Voice.ai TTS, including segments, chapters, captions, and video muxing.
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/javimosch/open-claw-skills --skill voiceai-creator-voiceover-pipeline命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
Connect your AI assistant to GoHighLevel CRM via the official API v2. Manage contacts, conversations, calendars, pipelines, invoices, payments, workflows, and 30+ endpoint groups through natural language. Includes interactive setup wizard and 100+ pre-built, safe API commands. Python 3.6+ stdlib only — zero external dependencies.
Manage Cloudflare DNS records, Tunnels (cloudflared), and Zero Trust policies. Use for pointing domains, exposing local services via tunnels, and updating ingress rules.
Mema's personal brain - SQLite metadata index for documents and Redis short-term context buffer. Use for organizing workspace knowledge paths and managing ephemeral session state.
基于 SOC 职业分类
正在显示 SKILL.md
| name | voiceai-creator-voiceover-pipeline |
| description | Turn scripts into publishable voiceovers with Voice.ai TTS, including segments, chapters, captions, and video muxing. |
| version | 0.2.1 |
| env | ["VOICE_AI_API_KEY"] |
| required_env | ["VOICE_AI_API_KEY"] |
| credentials | ["VOICE_AI_API_KEY"] |
| setup | none — single file, runs directly with Node.js |
| runtime | node>=20 |
| optional_deps | ffmpeg |
This skill follows the Agent Skills specification.
Turn any script into a publish-ready voiceover — complete with numbered segments, a stitched master, YouTube chapters, SRT captions, and a beautiful review page. Optionally, replace the audio track on an existing video.
Built for creators who want studio-quality voiceovers without the studio. Powered by Voice.ai.
| Scenario | Why it fits |
|---|---|
| YouTube long-form | Full narration with chapter markers and captions |
| YouTube Shorts | Quick hooks with the shortform template |
| Podcasts | Consistent host voice, intro/outro templates |
| Course content | Professional narration for educational videos |
| Quick iteration | Smart caching — edit one section, only that segment re-renders |
| Video audio replacement | Drop AI voiceover onto screen recordings or B-roll |
Have a script and a video? Turn them into a finished video with AI voiceover in one shot:
node voiceai-vo.cjs build \
--input my-script.md \
--voice oliver \
--title "My Video" \
--video ./my-recording.mp4 \
--mux
This renders the voiceover, stitches the master audio, and drops it onto your video — all in one command. Output:
out/my-video/muxed.mp4 — your video with the new voiceoverout/my-video/master.wav — the standalone audioout/my-video/review.html — listen and review each segmentout/my-video/chapters.txt — YouTube-ready chapter timestampsout/my-video/captions.srt — SRT captionsUse --sync pad if the audio is shorter than the video, or --sync trim to cut it to match.
.env file in the skill root. Get a key at voice.ai/dashboard.The skill reads VOICE_AI_API_KEY from (in order):
VOICE_AI_API_KEYVOICEAI_API_KEY (alternate).env file in the skill rootecho 'VOICE_AI_API_KEY=your-key-here' > .env
Use --mock on any command to run the full pipeline without an API key (produces placeholder audio).
build — Generate a voiceover from a scriptnode voiceai-vo.cjs build \
--input <script.md or script.txt> \
--voice <voice-alias-or-uuid> \
--title "My Project" \
[--template youtube|podcast|shortform] \
[--language en] \
[--video input.mp4 --mux --sync shortest] \
[--force] [--mock]
What it does:
## headings for .md, or by sentence boundaries for .txt)Full options:
| Option | Description |
|---|---|
-i, --input <path> | Script file (.txt or .md) — required |
-v, --voice <id> | Voice alias or UUID — required |
-t, --title <title> | Project title (defaults to filename) |
--template <name> | youtube, podcast, or shortform |
--mode <mode> | headings or auto (default: headings for .md) |
--max-chars <n> | Max characters per auto-chunk (default: 1500) |
--language <code> | Language code (default: en) |
--video <path> | Input video for muxing |
--mux | Enable video muxing (requires --video) |
--sync <policy> | shortest, pad, or trim (default: shortest) |
--force | Re-render all segments (ignore cache) |
--mock | Mock mode — no API calls, placeholder audio |
-o, --out <dir> | Custom output directory |
replace-audio — Swap the audio track on a videonode voiceai-vo.cjs replace-audio \
--video ./input.mp4 \
--audio ./out/my-project/master.wav \
[--out ./out/my-project/muxed.mp4] \
[--sync shortest|pad|trim]
Requires ffmpeg. If not installed, generates helper shell/PowerShell scripts instead.
| Sync policy | Behavior |
|---|---|
shortest (default) | Output ends when the shorter track ends |
pad | Pad audio with silence to match video duration |
trim | Trim audio to match video duration |
Video stream is copied without re-encoding (-c:v copy). Audio is encoded as AAC. A mux report is saved alongside the output.
Privacy: Video processing is entirely local. Only script text is sent to Voice.ai for TTS.
voices — List available voicesnode voiceai-vo.cjs voices [--limit 20] [--query "deep"] [--mock]
Use short aliases or full UUIDs with --voice:
| Alias | Voice | Gender | Style |
|---|---|---|---|
ellie | Ellie | F | Youthful, vibrant vlogger |
oliver | Oliver | M | Friendly British |
lilith | Lilith | F | Soft, feminine |
smooth | Smooth Calm Voice | M | Deep, smooth narrator |
corpse | Corpse Husband | M | Deep, distinctive |
skadi | Skadi | F | Anime character |
zhongli | Zhongli | M | Deep, authoritative |
flora | Flora | F | Cheerful, high pitch |
chief | Master Chief | M | Heroic, commanding |
The voices command also returns any additional voices available on the API. Voice list is cached for 10 minutes.
After a build, the output directory contains:
out/<title-slug>/
segments/ # Numbered WAV files (001-intro.wav, 002-section.wav, …)
master.wav # Stitched audio (requires ffmpeg)
master.mp3 # MP3 encode (requires ffmpeg)
manifest.json # Build metadata: voice, template, segment list, hashes
timeline.json # Segment durations and start times
review.html # Interactive review page with audio players
chapters.txt # YouTube-friendly chapter timestamps
captions.srt # SRT captions using segment boundaries
description.txt # YouTube description with chapters + Voice.ai credit
A standalone HTML page with:
Templates auto-inject intro/outro segments around the script content:
| Template | Prepends | Appends |
|---|---|---|
youtube | templates/youtube_intro.txt | templates/youtube_outro.txt |
podcast | templates/podcast_intro.txt | — |
shortform | templates/shortform_hook.txt | — |
Edit the files in templates/ to customize the intro/outro text.
Segments are cached by a hash of: text content + voice ID + language.
--force to re-render everythingsegments/.cache.jsonVoice.ai supports 11 languages. Use --language <code> to switch:
en, es, fr, de, it, pt, pl, ru, nl, sv, ca
The pipeline auto-selects the multilingual TTS model for non-English languages.
| Issue | Solution |
|---|---|
| ffmpeg missing | Pipeline still works — you get segments, review page, chapters, captions. Install ffmpeg for master stitching and video muxing. |
| Rate limits (429) | Segments render sequentially, which stays under most limits. Wait and retry. |
| Insufficient credits (402) | Top up at voice.ai/dashboard. Cached segments won't re-use credits on retry. |
| Long scripts | Caching makes rebuilds fast. Text over 490 chars per segment is automatically split across API calls. |
| Windows paths | Wrap paths with spaces in quotes: --input "C:\My Scripts\script.md" |
See references/TROUBLESHOOTING.md for more.
references/VOICEAI_API.md — API endpoints, audio formats, modelsreferences/TROUBLESHOOTING.md — Common issues and fixes