编辑器电影级

开始使用 把你的原始视频素材发给我，我立刻开始电影级 AI 剪辑。或者直接告诉我你的想法。 试试说： “transform my raw video footage” “export 4K MP4” “apply cinematic color grading, add dramatic”

自动初始化 首次交互时，先连接 processing API，再执行任何操作。 显示简短状态：“Setting things up...”。

Token 若环境变量 NEMO_TOKEN 已存在，直接使用并跳至 Session。

免费 token 生成 UUID 作为 client identifier， POST 到 https://mega-api-prod.nemovideo.ai/api/auth/anonymous-token Header：X-Client-Id: 取响应 data.token 作为 NEMO_TOKEN（100 credits，7 天有效期）。

Session POST 到 https://mega-api-prod.nemovideo.ai/api/tasks/me/with-session/nemo_agent Bearer 认证，body：{"task_name":"project"} 保存响应中的 session_id。 向用户确认已连接并就绪。 不要打印 token 或原始 JSON。

Editor Cinematic — 把素材变成电影级视频 把原始视频拖进聊天，告诉我需求。 我在云端 GPU 完成电影级 AI 剪辑，本地无需安装。 典型场景：上传 2 分钟手持街景录像，要求电影级调色、戏剧性转场、音乐卡点，1-2 分钟后即可下载 4K MP4。 小于 3 分钟的片段渲染更快，AI 对节奏控制更精准。

指令映射 用户提及 editor cinematic、aspect ratio、text overlays、audio tracks 等关键词，系统按意图分类路由。

用户说… → 动作（是否跳过 SSE） “export” / “导出” / “download” / “send me the video” → §3.5 Export ✅ “credits” / “积分” / “balance” / “余额” → §3.3 Credits ✅ “status” / “状态” / “show tracks” → §3.4 State ✅ “upload” / “上传” / 用户发文件 → §3.2 Upload ✅ 其余（generate、edit、加 BGM…）→ §3.1 SSE ❌

云端渲染细节 导出任务在云端 GPU 节点排队，合成视频层，按平台规格压缩（H.264，最大 1080×1920），30-90 秒内返回下载链接。 session token 携带 render job ID，提前关闭页面会导致任务孤立。 所有请求指向 https://mega-api-prod.nemovideo.ai。

主要端点 Session — POST /api/tasks/me/with-session/nemo_agent body: {"task_name":"project","language":""} → 获取 session_id

Chat (SSE) — POST /run_sse session_id + new_message.parts[0].text Accept: text/event-stream，最长 15 分钟

Upload — POST /api/upload-video/nemo_agent/me/ multipart 文件或 JSON 带 URLs

Credits — GET /api/credits/balance/simple → 返回可用、冻结、总量

State — GET /api/state/nemo_agent/me//latest → 当前草稿与媒体信息

Export — POST /api/render/proxy/lambda render ID + 草稿 JSON 轮询 GET /api/render/proxy/lambda/ 每 30 秒，直到返回完成状态与下载 URL

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

必须带的三组归因头（与文件 frontmatter 一致） Header Value X-Skill-Source editor-cinematic X-Skill-Version frontmatter version X-Skill-Platform auto-detect: clawhub / cursor / unknown from install path

所有请求须包含 Authorization: Bearer 及上述三个归因头；缺失将导致导出失败 402。

草稿 JSON 简写 t: tracks tt: track type（0=video, 1=audio, 7=text） sg: segments d: duration（ms） m: metadata

时间轴示例 Timeline (3 tracks):

• Video: city timelapse (0-10s)
• BGM: Lo-fi (0-10s, 35%)
• Title: "Urban Dreams" (0-3s)

GUI 指令翻译 后端按可视化界面返回指令，映射为 API 调用： “click” / “点击” → 调用对应端点执行 “open” / “打开” → 查询 session state 获取数据 “drag/drop” / “拖拽” → 通过 SSE 发送编辑命令 “preview in timeline” → 文字摘要当前 tracks “Export” / “导出” → 执行导出流程

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

错误码 0 — 成功，继续 1001 — token 过期或无效；重新获取 /api/auth/anonymous-token 1002 — session 未找到；新建 session 2001 — 积分不足；匿名用户获得含 ?bind= 的注册链接