# @cliptude/cli 中文文档

规范地址：https://npmcn.com/package/%40cliptude/cli/

版本：0\.1\.44
npm 元数据更新时间：2026-11-07T18:08:52.010Z
中文译文更新时间：2026-11-10T02:05:52.176Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40cliptude/cli
原文对照：https://npmcn.com/package/%40cliptude/cli/?lang=original
项目主页：https://github.com/cliptude/cliptude#readme
源码仓库：https://github.com/cliptude/cliptude

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：458 kB，28 个文件
- TypeScript 类型：未声明
- Node.js 要求：\>=18
- 运行依赖：0 个
- 首次发布：2026-08-24T09:36:25.639Z
- 最新版本发布：2026-11-07T18:08:51.808Z
- 近 30 天下载量：4525（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：30（近 12 个月 30 个）

## 中文简介

Cliptude CLI——从已保存的模板生成视频.

## 安装

```sh
npm install @cliptude/cli
```

也可以使用：`pnpm add @cliptude/cli`、`yarn add @cliptude/cli`、`bun add @cliptude/cli`

## README

# Cliptude CLI + MCP 软件

从保存模板生成视频 。 与spitchtude.com相同的账户和信用.

> 同样来自克利普图德: [真棒无脸YouTube自动化](https://github.com/cliptude/awesome-faceless-youtube-automation)包括工具、影片来源和无脸频道的YouTube政策.

## 设置

1.  安装 CLI: 运行 `npm i -g @cliptude/cli`。 。 。 .
2.  认证: 运行 `cliptude auth login` 并完成它打开的浏览器中的登录.
3.  安装伴奏技能: 运行 `npx skills add cliptude/cliptude`。 。 。 .

从此无 npm 重播:

```bash
pip install -e .
cliptude auth login
```

## Cliptude 桌面应用程序

桌面应用软件传送到此 CLI 和 MCP 服务器, 所以不需要安装: 在应用中, 打开 **设置 — 连接一个 AI 助手** 并单击 **添加** 用于 Claude 桌面或光标,或复制 命令 Claude Code 或 Codex。 视频然后在应用程序中用自己的提供商钥匙制作. ChatGPT只连接到互联网上的服务器,因此它使用shitchtude.com.

CLI和MCP提供工作的地方:

|  |  |
| --- | --- |
| `cliptude use desktop` | 运行中的桌面应用程序( 关闭时使用“ 打开 Cliptude ” 失败) |
| `cliptude use cloud` | cricttude.com (英语) |
| `cliptude use auto` (默认) | 运行时的桌面应用程序, 否则会剪辑. com |
| `cliptude use` | 显示现在的工作去向 |

`CLIPTUDE_TARGET` 覆盖已保存的选择,并且 `CLIPTUDE_BASE_URL` 二者皆能超越. 应用程序的端口 改变每次发射:CLI读自 `desktop-runtime.json` 及其密钥来自 `local-api.json` 在应用程序的数据文件夹中。 桌面只获得本地密钥并剪接.com只获得您剪接.com 登录。 A 类 `CLIPTUDE_API_KEY` 在环境中,没有 `CLIPTUDE_TARGET`(原始内容存档于2018-10-21). interesttude.com.

## 图标

```bash
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 edit <project-id> --ops '-' <<< '[{"op": "delete", "item_id": "anim-agent_g10"}, {"op": "retime", "item_id": "anim-agent_g11", "start_s": 109.3}]'
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` 使一个没有创建向导: 选择一个 `voice_id` 从 `voices`,则看到 `template-options` 对于每个其它字段,其选择和默认值(未设置字段为向导默认值)。 值像向导一样被验证;上传(风俗音乐,相声,字符)仍然需要向导. MCP 工具 : `get_template_options`, (中文(简体) ), `list_voices`, (中文(简体) ), `create_template`对于神通视频, `avatars` (多氯多氯乙烯) `list_avatars`列出您的外观; 设置一个 `--set avatar_profile_id=<id>` 打开 `template-create`,或用 `--avatar <id>` (和 `--avatar-engine iv|v`继续 `generate`, (中文(简体) ), `plan-job` 财务报告和审定财务报表 `estimate`。 。 。 对于矢量解释器, `vector-characters` 列出内置铸件和上传内容, `vector-character-upload --name "Dr. Maya" --file maya.png` (或 `--url`添加自己的,和 `--set vector_character_id=<id>` 打开 `template-create` (或 `--vector-character <id>` 打开 `generate` 编号 : `plan-job`)用之而来. 动议 : `--set vector_reveal_mode=none|video` 在模板上,或 `--vector-motion none|video` 打开 `generate`, (中文(简体) ), `plan-job` 财务报告和审定财务报表 `estimate` (单位:千美元)`none` 静态有相机动作, `video` =AI剪辑. 缩略图 : `--thumbnail-reference <YouTube link or image URL>` 或者说 `--thumbnail-prompt "<brief>"` 打开 `template-create` 设置模板的外观; 相同的旗帜 `generate` 财务报告和审定财务报表 `plan-job` 设置一个视频。 与两者都一样,每部视频都会为自己的标题选择一个风格参考.

先检查价格, `estimate` (多氯多氯乙烯) `estimate_credits`后退时 `POST /api/v1/jobs/estimate`) 以相同的模板和即时/刻写为 `generate` (上传为 `--voiceover-seconds` 编号 : `--talking-head-seconds`),并返回工作所需的信用以及账户是否拥有这些信用。 它创造和收费什么.

为了修改完成的视频, `editor` 打开其时间表(项目编号、时间、文本). `edit <project-id> --ops ops.json` 对这些id应用精确的编辑, 免费, 在一个修订版中: 删除、 重时、 修剪、 设置不透明/ 批量、 设置图形的道具、 设计或图片( 上传) `keep` id 或 https link),哑音一个图形的声音,添加图形,剪接或目录音效,设置过渡,重排标题,设置库音乐,其音量或去除,设置背景. `versions` 财务报告和审定财务报表 `restore` 撤销. `agent` 请求 Cliptude Agent 为需要源码或生成的开放式编辑(它收取代理信用; 参考项 IDs with `--items`),以及 `render` 导出新的 MP4 。 MCP 工具 : `open_editor_project`, (中文(简体) ), `get_editor_project`, (中文(简体) ), `edit_timeline`, (中文(简体) ), `list_editor_versions`, (中文(简体) ), `restore_editor_version`, (中文(简体) ), `run_agent`, (中文(简体) ), `get_agent_run`, (中文(简体) ), `cancel_agent_run`, (中文(简体) ), `render_project`, (中文(简体) ), `get_render`。 。 。 .

### 特工计划录影带

在"无脸纪录片","无脸TOP 10","Avatar Video"和"矢量解释"模板上,一个代理商可以计划每个视觉并离开 Cliptude 只有发票、来源和渲染:

1.  `cliptude plan-job` (停车) `plan_ready`, (中文(简体) ), `cliptude narration <job>`与每份工作一样,它首先用 音乐、音效、转换、动画和网络来源默认已打开 模板关闭( e)`no_music`, (中文(简体) ), `no_sound_effects`, (中文(简体) ), `no_transitions`, (中文(简体) ), `no_motion_graphics`,)需要用户的 核准时间 `--acknowledge`。 。 。 . 你自己的镜头: `cliptude upload-media <job> trailer.mp4 --split-shots` 将整个源切入选中的 3- 12 s 每个上传的笔记上写着建筑评论会报告什么(a) 水印,一端屏幕,标题.
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>`: 每张图片或剪辑(请检查使用 vs,链接到文件)和每张图形(道具) 它将被抽取,或者它为什么失踪. `cliptude plan-report <job>` 添加每个倒计时.
5.  为了修改, `plan-check` 编号 : `plan-lock` 同一工作的新计划 `continue` 重复: 相同的描述, 不变 媒体重新使用,没有更多的充电.
6.  一次显示 : `cliptude editor <job>`, (中文(简体) ), `cliptude render <project> --wait`。 。 。 .

目标为两座建筑:一座用于审查,一座用于运送. 技能的"一通"部分有工作顺序(footage progress, , 来源按镜头分出,人相先取出相片,按剧本分配相片,人相卡盖.

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`, (中文(简体) ), `clip_effects` 财务报告和审定财务报表 `sounds` (有预览). 计划计划和规则在 `skills/cliptude-plan/SKILL.md`。工作成本与网站价格相同.

### 商店的产品视频

将商店产品转换成6到60分钟的YouTube教育视频: 大约80%的教学,然后是产品及其 将真实相片合成到关闭板( 从未再生成) 。 任意shopify产品 URL 在没有设置的情况下工作; 其他 存储通过页面的结构化数据工作; 连接在 slicttude.com/ 集成/ stores/(或该存储)的存储 安装的 Cliptude Shopify app) 也可以被搜索.

```
cliptude product fetch https://store.com/products/handle        # product_id + 3 angles
cliptude product script <product-id> --angle 1 --duration 10-12 --discount-code YOUTUBE15
cliptude product status <job-id>                                 # until script_ready; review the script
cliptude product render <job-id> --aspect-ratio 16:9             # returns at once
cliptude product status <job-id>                                 # until ready_for_review; open editor_url
```

MCP 工具 : `fetch_product_context`, (中文(简体) ), `draft_product_script`, (中文(简体) ), `render_product_video`, (中文(简体) ), `get_product_video_status`。 。 。 . 他们中没有一个等待一个渲染; 投票状态工具.

`--title` 需要时间。 提供 **一个** 联 合 国 `--prompt`, (中文(简体) ), `--script` 编号 : `--script-file`, (中文(简体) ), `--voiceover`,或 `--talking-head`。永远不要将标题复制到 `--prompt`如果您只有一个话题, 请遵循 **剪贴画** (网络搜索) ——口述 —— `--script-file`),或者请 Cliptude 用 `cliptude script`。完成后 `script` 或者说 `voiceover` 职业, `cliptude continue <job-id>` 将同一任务转换成完整视频( 重用脚本; 语音任务重用 TTS 文件) . `--voiceover` 是一个本地音频文件( 与创建. html 相同); 它被转写并跳过 TTS —— 不将其与 proof/ slip 合并 . `--talking-head` 是一个在“说话头”模板(MP4、MOV、WEBM、AVI)上的介绍视频;它被转录并跳过TTS。 可选 `--duration` 是一个向导桶( w)`3-4`, (中文(简体) ), `6-8`, (中文(简体) ), `10-12`(中文(简体) ). 启用它以使用模板持续时间, 或是您通过时的字数估计 `--script`。从文件中上传音频或谈话头视频集持续时间。 神通视频模板可以覆盖 **只有阿凡达Intro** 财务报告和审定财务报表 **AI 图像 + AI 视频** 与 `--avatar-intro-only` 编号 : `--no-avatar-intro-only` 财务报告和审定财务报表 `--avatar-ai-footage` 编号 : `--no-avatar-ai-footage`关闭这些旗帜保存模板. `generate` 编号 : `script` 编号 : `voiceover` 编号 : `continue` 立即返回( e)`queued`) (中文(简体) ). 票价 `status`。 。 。 .

## MCP 磁共振

远程流式 HTTP : `https://mcp.cliptude.com/mcp` (OAuth 或 Bearer) (美国英语).

```bash
cliptude-mcp
```

未认证 `POST /mcp` 返回 401 与 `WWW-Authenticate` 指向 RFC 9728 元数据. Stdio除了JSON -RPC以外,从不写给Studout.

## 常见问题

### @cliptude/cli 是什么？

Cliptude CLI——从已保存的模板生成视频\.

### 如何安装 @cliptude/cli？

在项目目录运行 npm install @cliptude/cli，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 cliptude，可以用 npx cliptude 直接运行。

### @cliptude/cli 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/cliptude\_\_cli 是否存在。

### @cliptude/cli 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=18。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @cliptude/cli 可以商用吗？

@cliptude/cli 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @cliptude/cli 的下载量有多少？

根据 npm 官方下载统计，@cliptude/cli 在 2026/10/10 – 2026/11/08 这 30 天内被下载 4,525 次，日均约 151 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @cliptude/cli 还在维护吗？

最新版本 0\.1\.44 发布于 2026/11/08（2 天前）；至今共发布 30 个版本，其中过去 12 个月发布了 30 个；首次发布于 2026/08/24。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。