Cliptude

Cliptude CLI + MCP

使用已保存的模板生成视频。与 cliptude.com 使用同一账户和点数。

同样来自 Cliptude：Awesome Faceless YouTube Automation，这是一个精选列表，汇集了适用于无露脸频道的工具、视频素材来源和 YouTube 政策。

设置

1. 安装 CLI：运行 npm i -g @cliptude/cli。
2. 验证身份：运行 cliptude auth login，并在打开的浏览器中完成登录。
3. 安装配套技能：运行 npx skills add cliptude/cliptude（包含 cliptude、cliptude-script 和 cliptude-plan）。

不使用 npm，从此仓库安装：

pip install -e .
cliptude auth login

命令

cliptude templates
cliptude template-options --format faceless_documentary
cliptude voices --provider elevenlabs
cliptude template-create --name "TSMC doc" --format faceless_documentary --set voice_id=<id> --set voice_name=George --set generation_model=pro --set faceless_documentary_style=investigative
cliptude template-create --name "TSMC doc" --format faceless_documentary --settings-file settings.json
cliptude generate --template "Finance vector weekly" --title "Why index funds win" --prompt "why most retail traders underperform the S&P over 10 years, keep it for beginners" --duration 3-4
cliptude estimate --template "Finance vector weekly" --script-file script.txt
cliptude avatars --section mine
cliptude generate --template "My avatar weekly" --title "Episode one" --script-file script.txt --avatar 42
cliptude generate --template "Finance vector weekly" --title "Why index funds win" --script-file script.txt
cliptude generate --template "Finance vector weekly" --title "Why index funds win" --voiceover narration.mp3
cliptude generate --template "My talking head" --title "Weekly recap" --talking-head clip.mp4
cliptude generate --template "My avatar weekly" --title "Grandma egg trick" --script-file script.txt --avatar-ai-footage --avatar-intro-only
cliptude script --template "Finance vector weekly" --title "Why index funds win" --prompt "why most retail traders underperform the S&P" --duration 3-4
cliptude voiceover --template "Finance vector weekly" --title "Why index funds win" --script-file script.txt
cliptude download-voiceover <job-id> --out narration.mp3
cliptude editor <job-id>                                   # editor project id, revision, timeline item ids
cliptude agent <project-id> --prompt "Replace this shot with real footage of a TSMC fab" --items clip-1 --tier smart --wait
cliptude render <project-id> --wait                        # new MP4 of the edited timeline
cliptude continue <job-id>
cliptude status <job-id>

还没有模板？template-create 无需创建向导即可创建模板：从 voices 中选择一个 voice_id，并查看 template-options，了解所有其他字段、可选值和默认值（未设置的字段将采用向导默认值）。值的验证方式与向导相同；上传内容（自定义音乐、头像、角色）仍需通过向导完成。MCP 工具：get_template_options、list_voices、create_template。对于 Avatar Video，avatars（MCP list_avatars）会列出你的头像；使用 template-create 的 --set avatar_profile_id=<id> 设置头像，或在每个视频中使用 generate、plan-job 和 estimate 的 --avatar <id>（以及 --avatar-engine iv|v）覆盖设置。头像的性别必须与语音一致。对于 Vector Explainer，vector-characters 会列出内置角色和你上传的角色，使用 vector-character-upload --name "Dr. Maya" --file maya.png（或 --url）添加自己的角色，并在 template-create 中使用 --set vector_character_id=<id>（或在 generate / plan-job 中使用 --vector-character <id>）来指定角色。动态效果：在模板中使用 --set vector_reveal_mode=none|video，或在 generate、plan-job 和 estimate 中使用 --vector-motion none|video（none = 静态画面配合镜头移动，video = AI 视频片段）。缩略图：在 template-create 中使用 --thumbnail-reference <YouTube link or image URL> 或 --thumbnail-prompt "<brief>" 来设置模板风格；在 generate 和 plan-job 中使用相同标志来设置单个视频的风格。如果两者都未设置，每个视频会根据自己的标题选择风格参考。

如需先查看价格，estimate（MCP estimate_credits，REST POST /api/v1/jobs/estimate）接受与 generate 相同的模板和提示词/脚本（上传内容通过 --voiceover-seconds / --talking-head-seconds 指定时长），并返回任务所需点数以及账户是否有足够点数。它不会创建任务或扣除点数。

如需修改已完成的视频，editor 会打开其时间线（条目 ID、时间、文本），agent 会让 Cliptude Agent 执行编辑（会扣除 Agent 点数；使用 --items 引用条目 ID），render 则会导出新的 MP4。MCP 工具：open_editor_project、get_editor_project、run_agent、get_agent_run、cancel_agent_run、render_project、get_render。

Agent 规划的视频

在 Faceless Documentary、Faceless Top 10、Avatar Video 和 Vector Explainer 模板中，Agent 可以规划所有视觉内容，让 Cliptude 只负责配音、素材搜集和渲染：

1. cliptude plan-job（在 plan_ready 阶段停止）、cliptude narration <job>。
2. cliptude catalog --compact，然后使用 --types a,b 获取完整条目（--premium 仅列出高级素材库）。
3. 使用 cliptude plan-check <job> plan.json 检查计划，直到通过验证；然后运行 cliptude plan-lock <job> plan.json 和 cliptude continue <job>。 任务会在 ready_for_edit 阶段停止：视频已构建并计费，但尚未渲染。
4. cliptude plan-review <job>：查看每张图片或每段视频（请求的素材与实际使用的素材，以及文件链接）和每个图形（绘制时使用的元素，或缺失原因）。cliptude plan-report <job> 会额外列出每个后备素材。
5. 如需修改，在同一任务上对新计划运行 plan-check / plan-lock，然后再次运行 continue：旁白不变，未更改的媒体会复用，不会额外计费。
6. 渲染一次：cliptude editor <job>、cliptude render <project> --wait。

MCP 工具：create_plan_job、get_narration、get_kind_catalog、check_plan、lock_plan、get_plan、 continue_job、get_plan_review、get_plan_report，然后是 open_editor_project 和 render_project。 计划设定整体视觉风格（主题、风格、颜色、音乐）、每个图形各自的数据、颜色和声音、每个节拍对应的素材、每个剪辑点的转场、双图揭示效果，以及免费的音效；get_kind_catalog 会列出图形、transitions、reveal_styles 和 sounds（含预览）。计划的架构和规则见 skills/cliptude-plan/SKILL.md。任务费用与网站价格相同。

必须提供 --title。以下参数必须且只能提供一个：--prompt、--script / --script-file、--voiceover 或 --talking-head。不要将标题复制到 --prompt 中。如果只有主题，请遵循 cliptude-script（网页搜索 → 口语化旁白 → --script-file），或使用 cliptude script 让 Cliptude 撰写。script 或 voiceover 任务完成后，运行 cliptude continue <job-id>，即可将同一任务转为完整视频（复用脚本；voiceover 任务会复用 TTS 文件）。--voiceover 是本地音频文件（与 create.html 相同），系统会转录该文件并跳过 TTS——请勿将它与 prompt/script 同时使用。--talking-head 是 Talking Head 模板中的出镜讲解视频（MP4、MOV、WEBM、AVI）；系统会转录该视频并跳过 TTS。可选的 --duration 是向导提供的时长档位（3-4、6-8、10-12，……）。省略此参数则使用模板时长，或者在提供 --script 时使用字数估算时长。上传的音频或出镜讲解视频会根据文件时长设置视频时长。Avatar Video 模板可通过 --avatar-intro-only / --no-avatar-intro-only 和 --avatar-ai-footage / --no-avatar-ai-footage 覆盖 Avatar Intro Only 和 AI Image + AI Video 设置。省略这些标志则保留模板设置。generate / script / voiceover / continue 会立即返回（queued）。轮询 status。

MCP

远程 Streamable HTTP：https://mcp.cliptude.com/mcp（OAuth 或 Bearer）。

cliptude-mcp

未经身份验证的 POST /mcp 会返回 401，且 WWW-Authenticate 指向 RFC 9728 元数据。 Stdio 除 JSON-RPC 外不会向 stdout 写入任何内容。