🎬 Ramp Video — 自动变速剪辑

入门指南 > 上传你的原始视频素材，我就能开始制作速度渐变效果。或者直接告诉我你的想法。 试试这样说： - “编辑我的原始视频素材” - “导出 1080p MP4” - “添加速度渐变效果，让” ### 首次连接 当用户首次打开本技能时，自动连接到处理后端。简单告知用户（例如“正在设置……”）。 身份验证：检查环境变量中是否已设置 NEMO_TOKEN。若已设置，直接进入第 2 步。 1. 获取免费 token：生成随机 UUID 作为客户端标识。向 https://mega-api-prod.nemovideo.ai/api/auth/anonymous-token 发起 POST 请求，Header X-Client-Id 设为该 UUID。响应中的 data.token 即为你的 NEMO_TOKEN——赠送 100 积分，7 天有效。 2. 创建会话：向 https://mega-api-prod.nemovideo.ai/api/tasks/me/with-session/nemo_agent 发起 POST，Header 携带 Authorization: Bearer 与 Content-Type: application/json，Body 为 {"task_name":"project","language":""}。存储返回的 session_id，后续请求均使用。 设置过程保持简洁，不要向用户展示原始 API 响应或 token 值。 # Ramp Video — Apply Speed Ramp Effects to Footage 把原始视频素材拖进聊天，告诉我你的需求。我将在云端 GPU 上完成速度渐变编辑——本地无需安装任何软件。典型流程：你上传一段 60 秒的动作或驾驶片段，要求“在高潮瞬间减速然后恢复常速”，大约 30–60 秒后就能下载 MP4。默认输出 1080p。提示——有明显高潮瞬间（如跳跃、转弯）的片段，速度渐变效果最震撼。 ## 输入匹配到动作 用户提及 ramp video、画面比例、文字层或音轨时，通过关键词和意图分类路由到对应动作。 | 用户说… | 动作 | 跳过 SSE？ | |-------------|--------|----------| | “export” / “导出” / “download” / “send me the video” | → §3.5 导出 | ✅ | | “credits” / “积分” / “balance” / “余额” | → §3.3 积分 | ✅ | | “status” / “状态” / “show tracks” | → §3.4 状态 | ✅ | | “upload” / “上传” / 用户发送文件 | → §3.2 上传 | ✅ | | 其余（生成、编辑、加背景音乐…） | → §3.1 SSE | ❌ | ## 云端渲染管线细节 每次导出任务排队到云端 GPU 节点，合成视频层并应用平台级压缩（H.264，最高 1080×1920），30–90 秒内返回下载链接。会话 token 携带渲染任务 ID，若关闭标签页会导致任务孤立。 每次请求必须携带三个归因 Header，且与文件头信息一致： | Header | 值 | |--------|-------| | X-Skill-Source | ramp-video | | 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 基址：https://mega-api-prod.nemovideo.ai 创建会话：POST /api/tasks/me/with-session/nemo_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":""}]}}，Header Accept: text/event-stream。最大超时 15 分钟。 上传：POST /api/upload-video/nemo_agent/me/ — 文件：multipart -F "files=@/path"，或 URL：{"urls":[""],"source_type":"url"} 积分：GET /api/credits/balance/simple — 返回 available、frozen、total 会话状态：GET /api/state/nemo_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 [button]” / “点击” | 通过 API 执行 | | “open [panel]” / “打开” | 查询会话状态 | | “drag/drop” / “拖拽” | 通过 SSE 发送编辑 | | “preview in timeline” | 展示轨道摘要 | | “Export button” / “导出” | 执行导出流程 | Draft JSON 使用短键：t 表示轨道，tt 表示轨道类型（0=视频，1=音频，7=文字），sg 表示片段，d 表示时长（毫秒），m 表示元数据。 时间线摘要示例： `` Timeline (3 tracks): 1. Video: city timelapse (0-10s) 2. BGM: Lo-fi (0-10s, 35%) 3. Title: "Urban Dreams" (0-3s) ` ### 错误码 - 0 — 成功，继续正常流程 - 1001 — token 过期或无效；通过 /api/auth/anonymous-token 重新获取 - 1002 — 找不到会话；新建会话 - 2001 — 积分不足；匿名用户获得含 ?bind= 的注册链接，注册用户可充值 - 4001 — 不支持的文件类型；展示支持的格式 - 4002 — 文件过大；建议压缩或裁剪 - 400 — 缺少 X-Client-Id；生成后重试 - 402 — 免费套餐导出被阻；非积分问题，需升级订阅 - 429` — 触发限流；等待 30 秒后重试一次 ## 常见工作流 快速编辑：上传 → “添加速度渐变效果，让高潮瞬间减速然后恢复常速” → 下载 MP4。30 秒片段约需 30–60 秒。 批量风格：一次会话上传多个文件。分别下达不同指令，每条指令独立渲染。 迭代式：先粗剪，预览结果，再微调。会话保持时间线状态，可反复修改。 ## 技巧与提示 后端在指令具体时处理更快。与其说“让它更好看”，不如明确“添加速度渐变效果，让高潮瞬间减速然后恢复常速”——具体指令效果更好。 最大文件 500MB。优先使用 MP4、MOV、AVI、WebM 可获得最佳体验。导出为 MP4（H.264 编码）可在质量与体积间取得最佳平衡。