🎬 Animaker — 云端动画视频生成

入门指南 > 把图片、文本、素材发给我，我来帮你生成动画视频。或者直接告诉我你想要的效果。 试试这样说： - “create a set of character images and a script into a 1080p MP4” - “create a 60-second animated explainer video with characters and text overlays” - “creating animated explainer or marketing videos for marketers, educators, content creators” ### 快速开始配置 本技能连接云端处理后端。首次使用时自动建立连接，并告知用户（“Connecting...”）。 Token 检查：在环境中查找 NEMO_TOKEN。若存在，直接创建会话；否则： - 生成 UUID 作为 client identifier - 向 https://mega-api-prod.nemovideo.ai/api/auth/anonymous-token 发起 POST，附带 X-Client-Id 头 - 从响应中提取 data.token 即为 NEMO_TOKEN（100 免费积分，7 天有效期） 会话：POST https://mega-api-prod.nemovideo.ai/api/tasks/me/with-session/nemo_agent，使用 Bearer 鉴权，body 为 {"task_name":"project"}。保存返回的 session_id 供后续调用。配置完成后向用户简短提示“Ready!”。不要暴露 token 或原始 API 输出。 # Animaker — 创建并导出动画视频 把图片、文本、素材拖进对话框，告诉我需求。我将在云端 GPU 上完成动画渲染——本地无需安装任何软件。 典型流程：你发来一组角色图和脚本，要求“create a 60-second animated explainer video with characters and text overlays”，约 1-3 分钟后即可下载 MP4。默认输出 1080p。 小技巧：脚本越短、场景分段越清晰，渲染越快，画面越整洁。 ## 输入与动作映射 用户提到 animaker、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、add BGM…） | → §3.1 SSE | ❌ | ## 云端渲染流程细节 每次导出任务会在云端 GPU 节点排队，合成视频层并应用平台压缩（H.264，最大 1080×1920），30-90 秒内返回下载链接。会话 token 携带 render job ID，若提前关闭页面会导致任务孤立。 所有请求均发往 https://mega-api-prod.nemovideo.ai。主要端点： 1. Session — POST /api/tasks/me/with-session/nemo_agent，body 为 {"task_name":"project","language":""}，返回 session_id。 2. Chat (SSE) — POST /run_sse，携带 session_id 与 new_message.parts[0].text，设置 Accept: text/event-stream，最长 15 分钟。 3. Upload — POST /api/upload-video/nemo_agent/me/，支持 multipart 文件或含 URL 的 JSON。 4. Credits — GET /api/credits/balance/simple，返回 available、frozen、total。 5. State — GET /api/state/nemo_agent/me//latest，获取当前草稿与媒体信息。 6. Export — POST /api/render/proxy/lambda，提交 render ID 与草稿 JSON。随后每 30 秒轮询 GET /api/render/proxy/lambda/ 直至 completed 并获得下载链接。 支持格式：mp4、mov、avi、webm、mkv、jpg、png、gif、webp、mp3、wav、m4a、aac。 技能归因——运行时读取本文件 YAML frontmatter： - X-Skill-Source: animaker - X-Skill-Version: 取自 frontmatter 的 version - X-Skill-Platform: 根据安装路径检测（~/.clawhub/ → clawhub，~/.cursor/skills/ → cursor，其他 → unknown） 每次 API 调用需携带 Authorization: Bearer 及上述三个归因头。缺失任一头将返回 402。 草稿 JSON 使用短键：t 表示 tracks，tt 表示 track type（0=video, 1=audio, 7=text），sg 表示 segments，d 表示时长（毫秒），m 表示 metadata。 时间轴示例： `` Timeline (3 tracks): 1. Video: city timelapse (0-10s) 2. BGM: Lo-fi (0-10s, 35%) 3. Title: "Urban Dreams" (0-3s) ` ### GUI 指令翻译 后端按可视化界面方式返回指令，将其映射为 API 调用： - “click” 或 “点击” → 通过对应端点执行动作 - “open” 或 “打开” → 查询会话状态获取数据 - “drag/drop” 或 “拖拽” → 经 SSE 发送编辑命令 - “preview in timeline” → 以文本摘要形式展示当前 tracks - “Export” 或 “导出” → 运行导出工作流 ### SSE 流读取 文本事件直接回给用户（经 GUI 翻译后）。工具调用内部完成。心跳及空 data: 行表示后端仍在处理——每 2 分钟显示“⏳ Still working...”。约 30% 编辑操作会无文本关闭流，此时需轮询 /api/state 确认时间轴变化，再告知用户更新内容。 ### 错误处理 | 代码 | 含义 | 处理方式 | |------|---------|--------| | 0 | 成功 | 继续 | | 1001 | token 无效或过期 | 通过 anonymous-token 重新鉴权（token 7 天过期） | | 1002 | 会话不存在 | 新建会话 §3.0 | | 2001 | 积分不足 | 匿名：展示带 ?bind= 的注册链接（` 取自 create-session 或 state 响应）。已注册：“请在账户内充值积分” | | 4001 | 不支持的文件 | 展示支持格式 | | 4002 | 文件过大 | 建议压缩/裁剪 | | 400 | 缺失 X-Client-Id | 生成 Client-Id 并重试（见 §1） | | 402 | 免费套餐导出受限 | 订阅层级问题，非积分。“请注册或升级套餐以解锁导出。” | | 429 | 限流（1 token/客户端/7 天） | 30 秒后重试一次 | ## 使用技巧 后端处理速度取决于指令明确程度。比起“make it look better”，说“create a 60-second animated explainer video with characters and text overlays” 这类具体描述效果更优。 文件最大 200MB。优先使用 MP4、MOV、GIF、WebM 可获得最佳体验。导出为 MP4 可在社交与演示平台获得最广兼容。 ## 常见工作流 快速编辑：上传 → “create a 60-second animated explainer video with characters and text overlays” → 下载 MP4。30 秒片段约 1-3 分钟完成。 批量处理：同一会话内上传多个文件，逐条下达不同指令，每条独立渲染。 迭代优化：先粗剪并预览，再逐步微调。会话会保存时间轴状态，可反复修改。