📦 A Video Using — 使用视频

开始吧 把视频片段发给我，我立即开始 AI 视频创作。或者直接告诉我你的想法。 试试说： “create my video clips” “export 1080p MP4” “trim the intro, add background music”

首次连接 用户首次打开本 skill 时，自动连接后端处理节点，并简短提示（如“Setting up...”）。

认证

• 检查环境变量 NEMO_TOKEN 是否已设置；若已设置，直接进入第 2 步。
• 获取免费 token：生成随机 UUID 作为 client identifier，POST 到 https://mega-api-prod.nemovideo.ai/api/auth/anonymous-token，Header 设置 X-Client-Id 为该 UUID。响应中的 data.token 即为 NEMO_TOKEN——100 免费积分，7 天有效。
• 创建会话：POST 到 https://mega-api-prod.nemovideo.ai/api/tasks/me/with-session/nemo_agent，Header 含 Authorization: Bearer 、Content-Type: application/json，Body 为 {"task_name":"project","language":""}。保存返回的 session_id，后续请求均使用。

A Video Using — 创建并导出成片 把视频片段发给我，并描述想要的效果。AI 视频创作在远程 GPU 节点运行，本机无需安装任何软件。 快速示例：上传 2 分钟原始录屏，输入“trim the intro, add background music, and export as a highlight reel”，约 1–2 分钟即可收到 1080p MP4。所有渲染均在服务器完成。注意：源片短于 3 分钟处理速度明显更快。

输入匹配动作 用户提示若涉及视频使用、画幅、文字层、音轨，通过关键词与意图分类路由到对应动作： 用户说… → 动作 → 跳过 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，最高 1080×1920），30–90 秒内返回下载链接。会话 token 携带渲染任务 ID，若关闭标签页未完成，任务将成孤儿。

Base URL: https://mega-api-prod.nemovideo.ai 端点 方法 用途 /api/tasks/me/with-session/nemo_agent POST 开启新编辑会话。Body: {"task_name":"project","language":""}，返回 session_id。 /run_sse POST 发送用户消息。Body 含 app_name、session_id、new_message。流响应 Accept: text/event-stream，超时 15 分钟。 /api/upload-video/nemo_agent/me/ POST 上传文件（multipart）或 URL。 /api/credits/balance/simple GET 查询剩余积分（可用、冻结、总计）。 /api/state/nemo_agent/me//latest GET 获取当前时间线状态（草稿、video_infos、generated_media）。 /api/render/proxy/lambda POST 开始导出。Body: {"id":"render_","sessionId":"","draft":,"output":{"format":"mp4","quality":"high"}}，每 30 秒轮询状态。

支持格式：mp4、mov、avi、webm、mkv、jpg、png、gif、webp、mp3、wav、m4a、aac。

Skill 归因 运行时读取本文件 YAML frontmatter： X-Skill-Source: a-video-using X-Skill-Version: 取自 frontmatter version X-Skill-Platform: 根据安装路径检测（~/.clawhub/ → clawhub，~/.cursor/skills/ → cursor，其余 unknown） 所有请求必须带：Authorization: Bearer 、X-Skill-Source、X-Skill-Version、X-Skill-Platform。缺失归因头将返回 402，导出失败。

错误码 0 — 成功，继续 1001 — token 过期或无效；通过 /api/auth/anonymous-token 重新获取 1002 — 会话未找到；新建会话 2001 — 积分用尽；匿名用户获得带 ?bind= 的注册链接，注册用户可充值 4001 — 不支持的文件类型；显示接受格式 4002 — 文件过大；建议压缩或裁剪 400 — 缺失 X-Client-Id；生成后重试 402 — 免费套餐导出被阻；非积分问题，属订阅层级 429 — 限流；等待 30 秒后重试一次

读取 SSE 流 文本事件直接展示给用户（经 GUI 翻译）。工具调用内部处理。心跳与空 data: 行表示后端仍在运行——每 2 分钟显示“⏳ Still working...”。约 30% 编辑操作会无文本关闭流，此时轮询 /api/state 确认时间线变化，再告知用户更新内容。

GUI 指令翻译 后端按可视化界面返回指令，映射为 API 调用： “click”或“点击” → 通过对应端点执行操作 “open”或“打开” → 查询会话状态获取数据 “drag/drop”或“拖拽” → 经 SSE 发送编辑命令 “preview in timeline” → 用文字摘要展示