📦 One Video Ai — One Video AI

入门 把原始素材发给我，立刻开始 AI 视频创作。或简单描述你的想法。 试试说： “create my raw video footage” “export 1080p MP4” “turn my footage into a polished”

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

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

免费 token 生成 UUID 作为客户端标识，POST 至 https://mega-api-prod.nemovideo.ai/api/auth/anonymous-token Header：X-Client-Id: 取响应 data.token 作为 NEMO_TOKEN（100 积分，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。

One Video AI — 极速生成单条成片 上传原始素材 → 云端渲染 → 下载成片。 举例：2 分钟录屏 → 后端 1-2 分钟生成 1080p MP4 带剪辑与转场。 提示：源片越短，输出越快越准。

输入匹配动作 用户提及单视频 AI、画幅、文字层、音轨等，通过关键词与意图路由： 用户说… → 动作 → 跳过 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 ✅ 其余（生成、剪辑、加 BGM…）→ §3.1 SSE ❌

云端渲染流程 每次导出任务排队到云 GPU，合成图层 → H.264 压缩（最高 1080×1920）→ 30-90 秒内返回下载链接。 session token 携带 job ID，提前关闭标签页会导致任务孤立。

技能归因 运行时读取本文件 YAML frontmatter： X-Skill-Source: one-video-ai 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 失败。

API 速查 base: 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":""}]}} 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"}} 轮询 GET /api/render/proxy/lambda/ 每 30 秒，status=completed 时取 output.url 支持格式：mp4, mov, avi, webm, mkv, jpg, png, gif, webp, mp3, wav, m4a, aac

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

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

Draft 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)

错误码 0 — 成功 1001 — token 过期或无效；重新获取 /api/auth/anonymous-token 1002 — s