SuperAPI AI 工具集

ai-image-to-video-generator

设计与创作

查看项目

更新于 11-01 21:29

技能介绍

用途

该技能用于把静态图片转化为具有动态运动效果的视频。用户无需操作时间线、关键帧或运动曲线,只需用自然语言描述希望图片如何运动,例如平缓的视差漂移、戏剧性缩放、流动粒子效果或场景转场,即可获得符合创作意图的渲染视频。

主要能力

  • 对话式生成:通过 OpenClaw 智能体解释用户指令,与底层 AI 视频合成后端通信,并支持多轮迭代调整运动速度、方向、循环行为与视觉风格。
  • 基于源图的运动合成:后端分析源图的深度、主体边界与视觉构图,生成合理连贯的运动,而非幻灯片或平移扫描效果。
  • 多格式导出:最终导出支持 mp4、mov、avi、webm、mkv。
  • 两阶段生成:原始视频生成后,后端会自动进行第二阶段处理,叠加背景音乐与标题序列。
  • 文件上传:支持 mp4、mov、avi、webm、mkv、jpg、png、gif、webp、mp3、wav、m4a、aac 格式,可通过本地文件或 URL 上传。
  • 积分与状态查询:可查询可用积分余额,并轮询任务状态(草稿、视频信息、画布配置、已生成媒体等)。
  • 导出交付:导出不消耗积分,仅生成/编辑消耗积分;导出后返回下载链接,并附带任务详情链接。

使用方式

首次接触时技能会主动问候用户,并在后台静默完成自动设置:检查 NEMO_TOKEN 环境变量,若无则读取或生成 Client-ID(持久化到 ~/.config/nemovideo/client_id),通过匿名令牌接口获取令牌(100 免费积分),并创建会话。

环境变量包括:NEMO_TOKEN(可选,自动生成,100 免费积分,7 天过期,可在 Settings → API Tokens 撤销)、NEMO_API_URL(默认 https://mega-api-prod.nemovideo.ai)、NEMO_WEB_URL(默认 https://nemovideo.com)、NEMO_CLIENT_ID(自动生成 UUID)、SKILL_SOURCE(自动检测)。

主要操作流程:

  1. 建立会话:POST $API/api/tasks/me/with-session/nemo_agent,创建 task_id 与 session_id,并返回可在浏览器中查看/编辑任务的链接。
  2. 通过 SSE 传递消息:POST $API/run_sse,所有对话消息经 Server-Sent Events 连接传输。文本响应 5-15 秒,视频生成 100-300 秒,编辑 10-30 秒。
  3. 文件上传:POST $API/api/upload-video/nemo_agent/me/<sid>,支持本地文件或 URL。
  4. 查询积分:GET $API/api/credits/balance/simple。
  5. 轮询任务状态:GET $API/api/state/nemo_agent/me/<sid>/latest。
  6. 导出:POST $API/api/render/proxy/lambda,轮询状态(每 30 秒,最多 10 次),从 output.url 下载。

所有 API 请求必须包含 X-Skill-Source、X-Skill-Version、X-Skill-Platform 请求头,缺失会导致导出失败(402)。

适用场景

适合需要将单张静态图片转化为动态视频的创作场景,例如为图片添加电影感运动、制作短视频素材、为图像增加视差或粒子效果等。用户可通过对话持续调整,直到结果符合预期。

限制

  • 生成任务可能需要数分钟,无法实时交付。
  • 每个会话不支持超过一个并发生成任务。
  • 源图片必须满足最低分辨率要求,否则上传会被拒绝。
  • 背景音乐与标题叠加为自动应用,无法通过 API 单独禁用。
  • 积分余额通过 API 只读,充值需通过平台计费界面处理。
  • 匿名令牌每个客户端每 7 天 1 个,过期后可用同一 X-Client-Id 重新申请。
  • 免费计划导出可能被阻止(402),属于订阅层级问题而非积分问题。

错误处理

常见错误码:0 成功;1001 令牌无效/过期(重新匿名认证);1002 会话未找到(新建会话);2001 无积分(匿名用户显示注册链接,注册用户提示充值);4001 不支持的文件;4002 文件过大;400 缺少 X-Client-Id;402 免费计划导出被阻止;429 速率限制(30 秒后重试一次)。