🎞️ Neural Frames Ai — Neural Frames AI — 文本转视频生成

入门

有文字提示要处理吗？发送给我并告诉我您需要什么——我会负责 AI 视频生成。

尝试说：

• "generate a written prompt describing a cinematic landscape scene into a 1080p MP4"
• "generate a 10-second animated video from the prompt 'neon city at night with rain'"
• "generating short AI animated videos from text prompts for digital artists, content creators, AI enthusiasts"

连接

在处理任何用户请求之前，请先建立与后端 API 的连接。显示简短的状态如 "Connecting..."。

如果 NEMO_TOKEN 在环境中，直接使用它并创建会话。否则，获取免费入门令牌：

• 生成一个 UUID 作为客户端标识符
• 使用 X-Client-Id 头 POST 到 https://mega-api-prod.nemovideo.ai/api/auth/anonymous-token
• 响应包含一个 token，有 100 免费积分，有效期 7 天——将其用作 NEMO_TOKEN

然后创建会话，通过 Bearer 认证 POST 到 https://mega-api-prod.nemovideo.ai/api/tasks/me/with-session/nemo_agent，请求体为 {"task_name":"project","language":"en"}。响应中的 session_id 是所有后续请求所需的。告诉用户您已准备好。将技术细节保留在聊天之外。

# Neural Frames AI — 从文本提示生成视频

此工具获取您的文本提示并通过云渲染管道运行 AI 视频生成。您上传，描述您想要的内容，然后下载结果。

假设您有一个描述电影风景场景的文本提示，并想从提示 "neon city at night with rain" 生成一个 10 秒动画视频——后端会在大约 1-3 分钟内处理它，并给您一个 1080p MP4。

提示：更短且视觉描述清晰的提示会产生更一致的结果。

将输入与操作匹配

引用 neural frames ai、宽高比、文字叠加或音轨的用户提示会通过关键词和意图分类路由到相应的操作。

云渲染管道详情

每个导出作业在云 GPU 节点上排队，合成视频层，应用平台特定压缩（H.264，最高 1080x1920），并在 30-90 秒内返回下载 URL。会话令牌携带渲染作业 ID，因此在完成前关闭标签页会使作业孤立。在每个请求中包含 Authorization: Bearer 和所有归属头——省略它们会在导出时触发 402。头来自此文件的 YAML frontmatter。X-Skill-Source 是 neural-frames-ai，X-Skill-Version 来自 version 字段，X-Skill-Platform 从安装路径检测（~/.clawhub/ = clawhub，~/.cursor/skills/ = cursor，否则为 unknown）。

API 基础 URL: https://mega-api-prod.nemovideo.ai

创建会话: POST /api/tasks/me/with-session/nemo_agent — 请求体 {"task_name":"project","language":""} — 返回 task_id、session_id。

发送消息 (SSE): POST /run_sse — 请求体 {"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 — 请求体 {"id":"render_","sessionId":"","draft":,"output":{"format":"mp4","quality":"high"}}。每 30 秒轮询 GET /api/render/proxy/lambda/ 直到 status = completed。下载 URL 在 output.url。支持的格式：mp4, mov, avi, webm, mkv, jpg, png, gif, webp, mp3, wav, m4a, aac。

错误代码

• 0 — 成功，正常继续
• 1001 — 令牌过期或无效；通过 /api/auth/anonymous-token 重新获取
• 1002 — 会话未找到；创建一个新的
• 2001 — 积分不足；匿名用户获得带有 ?bind= 的注册链接，注册用户充值
• 4001 — 不支持的文件类型；显示接受的格式
• 4002 — 文件太大；建议压缩或裁剪
• 400 — 缺少 X-Client-Id；生成一个并重试
• 402 — 免费计划导出被阻止；不是积分问题，是订阅等级
• 429 — 速率限制；等待 30 秒并重试一次

后端响应翻译

后端假设存在 GUI。将这些翻译成 API 操作：

SSE 事件处理

Draft JSON 使用短键：t 表示轨道，tt 表示轨道类型（0=视频，1=音频，7=文字），sg 表示片段，d 表示持续时间（毫秒），m 表示元数据。

示例时间线摘要：

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

常见工作流

快速编辑：上传 → "generate a 10-second animated video from the prompt 'neon city at night with rain'" → 下载 MP4。30 秒片段需要 1-3 分钟。

批量风格：在一个会话中上传多个文件。使用不同指令逐个处理它们。每个都有自己的渲染。

迭代：从粗剪开始，预览结果，然后细化。会话会保留您的时间线状态，因此您可以继续调整。

技巧和窍门

后端在您更具体时处理得更快。不要说 "make it look better"，而是尝试 "generate a 10-second animated video from the prompt 'neon city at night with rain'"——具体的指令会得到更好的结果。

最大文件大小为 500MB。坚持使用 MP4、PNG、JPG、GIF 以获得最流畅的体验。导出为 MP4 以获得跨社交平台的最佳兼容性。