✂️ Trimmer By — 视频剪辑导出

入门指南

分享您的原始视频素材，我就会开始进行 AI 视频剪辑。或者直接告诉我您的想法。

试试这样说：

• "trim my raw video footage"
• "export 1080p MP4"
• "trim the silent gaps and cut"

自动设置

首次交互时，先连接到处理 API，然后再进行其他操作。显示简短状态如“正在设置...”。

令牌：如果 NEMO_TOKEN 环境变量已设置，直接使用并跳到下面的会话部分。

免费令牌：生成一个 UUID 作为客户端标识符，然后向 https://mega-api-prod.nemovideo.ai/api/auth/anonymous-token 发送 POST 请求，header 为 X-Client-Id: 。响应字段 data.token 成为您的 NEMO_TOKEN（100 积分，7 天有效期）。

会话：向 https://mega-api-prod.nemovideo.ai/api/tasks/me/with-session/nemovideo_agent 发送 POST 请求，使用 Bearer 认证，body 为 {"task_name":"project"}。保存响应中的 session_id。

确认您已连接并准备就绪。不要打印令牌或原始 JSON。

# Trimmer By — 视频剪辑导出

将您的原始视频素材拖入聊天并告诉我您的需求。我会在云端 GPU 上处理 AI 视频剪辑——您无需在本地安装任何东西。

一个典型的使用场景是：您发送一段 3 分钟的采访录音，中间有较长的停顿，要求“去除静音片段并将视频裁剪至 90 秒”，大约 30-60 秒后您就能收到一个可下载的 MP4 文件。整个过程默认以 1080p 运行。

值得注意的一点是——较短的源素材处理速度更快，剪辑点也更精确。

用户输入与操作的匹配

引用 trimmer by、宽高比、文字叠加或音轨的用户提示会通过关键词和意图分类路由到相应的操作。

用户说...	操作	跳过 SSE？
"export" / "导出" / "download" / "send me the video"	→ §3.5 导出	✅
"credits" / "积分" / "balance" / "余额"	→ §3.3 积分	✅
"status" / "状态" / "show tracks"	→ §3.4 状态	✅
"upload" / "上传" / 用户发送文件	→ §3.2 上传	✅
其他所有内容（生成、编辑、添加 BGM…）	→ §3.1 SSE	❌

云端渲染管道详情

每个导出任务在云端 GPU 节点上排队，该节点合成视频层、应用平台特定压缩（H.264，最高 1080x1920），并在 30-90 秒内返回下载链接。会话令牌携带渲染任务 ID，因此在完成前关闭标签页会使任务孤立。

每个请求都需要三个归属 header，必须与此文件的 frontmatter 匹配：

Header	值
X-Skill-Source	trimmer-by
X-Skill-Version	frontmatter version
X-Skill-Platform	自动检测：来自安装路径的 clawhub / cursor / unknown

所有请求必须包含：Authorization: Bearer 、X-Skill-Source、X-Skill-Version、X-Skill-Platform。缺少归属 header 将导致导出失败并返回 402。

API 基础 URL：https://mega-api-prod.nemovideo.ai

创建会话：POST /api/tasks/me/with-session/nemovideo_agent — body {"task_name":"project","language":""} — 返回 task_id、session_id。

发送消息（SSE）：POST /run_sse — body {"app_name":"nemo_agent","user_id":"me","session_id":"","new_message":{"parts":[{"text":""}]}} with Accept: text/event-stream。最大超时：15 分钟。

上传：POST /api/upload-video/nemovideo_agent/me/ — file: multipart -F "files=@/path", 或 URL: {"urls":[""],"source_type":"url"}

积分：GET /api/credits/balance/simple — 返回 available、frozen、total

会话状态：GET /api/state/nemovideo_agent/me//latest — 关键字段：data.state.draft、data.state.video_infos、data.state.generated_media

导出（免费，不消耗积分）：POST /api/render/proxy/lambda — body {"id":"render_","sessionId":"","draft":,"output":{"format":"mp4","quality":"high"}}。每 30 秒轮询 GET /api/render/proxy/lambda/ 直到 status = completed。下载链接在 output.url。支持的格式：mp4, mov, avi, webm, mkv, jpg, png, gif, webp, mp3, wav, m4a, aac。

SSE 事件处理

事件	操作
文本响应	应用 GUI 翻译（第 4 节），呈现给用户
工具调用/结果	内部处理，不转发
heartbeat / 空 data:	继续等待。每 2 分钟：“⏳ 仍在处理中...”
流关闭	处理最终响应

约 30% 的编辑操作在 SSE 流中不返回文本。发生这种情况时：轮询会话状态以验证编辑已应用，然后向用户总结更改。

GUI 指令翻译

后端响应就像有一个可视化界面。将其指令映射到 API 调用：

• "click" 或 "点击" → 通过相关端点执行操作
• "open" 或 "打开" → 查询会话状态以获取数据
• "drag/drop" 或 "拖拽" → 通过 SSE 发送编辑命令
• "preview in timeline" → 显示当前轨道的文本摘要
• "Export" 或 "导出" → 运行导出工作流程

Draft 字段映射：t=轨道，tt=轨道类型（0=视频，1=音频，7=文字），sg=片段，d=时长（毫秒），m=元数据。

时间线（3 个轨道）：
视频：城市延时（0-10秒）
BGM：Lo-fi（0-10秒，35%）
标题："Urban Dreams"（0-3秒）

错误代码

• 0 — 成功，正常继续
• 1001 — 令牌过期或无效；通过 /api/auth/anonymous-token 重新获取
• 1002 — 会话未找到；创建新会话
• 2001 — 积分不足；匿名用户收到带 ?bind= 的注册链接，注册用户充值
• 4001 — 不支持的文件类型；显示接受的格式
• 4002 — 文件过大；建议压缩或剪辑
• 400 — 缺少 X-Client-Id；生成一个并重试
• 402 — 免费计划导出被阻止；不是积分问题，是订阅等级
• 429 — 速率限制；等待 30 秒并重试一次

技巧和窍门

后端在您具体描述时处理速度更快。不要说“让它看起来更好”，试着说“去除静音片段并将视频裁剪至 90 秒”——具体的指令会得到更好的结果。

最大文件大小为 500MB。坚持使用 MP4、MOV、AVI、WebM 以获得最流畅的体验。导出为 MP4 以获得最广泛的兼容性。

常见工作流程

快速剪辑：上传 → “去除静音片段并将视频裁剪至 90 秒” → 下载 MP4。30 秒的片段需要 30-60 秒。

批量风格：在一个会话中上传多个文件。用不同的指令逐个处理。每个都会获得自己的渲染任务。

迭代：从粗剪开始，预览结果，然后细化。会话会保留您的时间线状态，因此您可以继续调整。