微缩模型搭建与微缩场景视频生成
深夜:一个火柴盒大小的日本便利店散发着琥珀色光芒;镜头从黑暗中缓缓向它推进——焦外的世界被吞没,而玻璃门、货架和微小的荧光灯却保持清晰。这种“小而真实”的沉浸感正是本技能所要捕捉的情感共鸣点。
便利店、雨夜拉面摊、赛博朋克工作室——或者一张成品模型的照片:一行文字或一张图片 → 一段视频。
依赖项: WERYAI_API_KEY + Node.js 18+。运行 CLI 时,scripts/video_gen.js 必须存在;WERYAI_VIDEO_API.md 必须存在于 resources/ 目录下(通过发布或使用前组装提供)。完整命令和 JSON 字段请参见 resources/WERYAI_VIDEO_API.md。无需其他 Cursor 技能。默认参数和模型层级见下方表格;实时 API 限制遵循 weryai 模型。在安装或运行前,请检查随附的 video_gen.js 以确保其符合你的要求。特别注意它如何处理本地文件(如果你允许使用的话),确保其行为符合本技能预期的图像转视频工作流程。
注册表元数据: 唯一必需的运行时密钥是 WERYAI_API_KEY。它出现在 YAML frontmatter 中,作为顶级 requires.env(用于展平根键的工具的 flow mapping)、metadata.openclaw.primaryEnv 和 metadata.openclaw.requires.env。技能目录和注册表应在安装前明确告知这一要求,以便在下载前让用户知晓。切勿将密钥提交到包内。
安装或设置 WERYAI_API_KEY 之前
- 信任: 确认你信任 WeryAI,并接受将提示词和图像输入(URL,以及如果使用的话,上传的字节)通过网络发送到 WeryAI 的服务器。
- 敏感内容: 不要在
prompt中包含密钥。不要提供你认为敏感的图像 URL 或本地文件,除非你接受服务端处理。 - 先使用
--dry-run: 在设置密钥前,先运行node scripts/video_gen.js wait --json '…' --dry-run(和/或submit-*配合--dry-run)以检查 JSON 结构;仅--dry-run不需要WERYAI_API_KEY(参见WERYAI_VIDEO_API.md)。 - 来源: 如果无法验证包作者或需要严格的数据控制,不要设置
WERYAI_API_KEY,或者仅在隔离/测试环境中运行。
环境变量(随附的 video_gen.js)
- 真实 API 调用所需:
WERYAI_API_KEY仅此一个(用于模型、生成、status、本地图像上传)。仅--dry-run不需要。 - 本脚本不读取: 环境变量不覆盖 API 主机名;
https://api.weryai.com和https://api-growth-agent.weryai.com是代码中固定的(参见安全说明)。不要指望有 URL 覆盖旋钮——此构建中没有。 - 轮询:
wait使用脚本中固定的指数退避和超时常量(参见WERYAI_VIDEO_API.md),此包中没有单独的轮询环境变量。
脚本与技能默认值(必须与 JSON 一致)
model: CLI 没有内置的默认模型。如果 JSON 中缺少或为空的model,video_gen.js返回MISSING_PARAM(no default model)。此技能推荐的表格默认值是KLING_V3_0_PRO——始终在wait/submit-*JSON 中显式传递"model":"<确认的键>",以使其与提交前表格匹配。resolution: 对于KLING_V3_0_PRO(此技能的默认层级),完全从 JSON 中省略resolution——对于不支持该字段的模型,发送它可能导致1002/ 参数错误。仅在所选模型在node scripts/video_gen.js models中列出它,并且你的确认表格明确包含它时,才添加resolution。
前提条件
- 运行
video_gen.js前,必须设置WERYAI_API_KEY环境变量。 - 需要 Node.js 18+。优先使用公开的
https图像 URL。如果组装的scripts/video_gen.js支持本地文件路径,请先检查和验证脚本,然后在读取本地图像并上传到 WeryAI 以获取公开 URL 之前获得明确同意。 - 每次成功的
wait运行都会消耗 WeryAI 积分;重新运行会创建新的付费任务。
安全、密钥和 API 主机
WERYAI_API_KEY:将其视为密钥。仅在你信任此技能来源时才进行配置;它在 OpenClaw 元数据中列为requires.env/primaryEnv,以便安装程序知道其在运行时是强制性的(切勿将其提交到技能包内)。- API 主机(在
video_gen.js中固定):视频任务使用https://api.weryai.com;模型列表使用https://api-growth-agent.weryai.com。随附脚本在代码中固定了这些基础地址——仅从环境中读取WERYAI_API_KEY用于身份验证。不要依赖任何环境变量来更改 API 主机名;请求仅发送到这些官方端点以及上传本地图像时的文档化上传 URL(参见WERYAI_VIDEO_API.md)。 - 本地图像处理说明:优先使用公开的
https图像 URL。如果组装的scripts/video_gen.js支持本地文件路径,它可能会读取本地图像并上传到 WeryAI 以获取公开 URL;使用该路径前需要审查/验证并获得明确同意。 - 远程处理: 付费运行会将
prompt和图像输入发送到 WeryAI;参见## 安装或设置 WERYAI_API_KEY 之前。 - 更高保证: 遵循
## 安装或设置 WERYAI_API_KEY 之前;对付费运行使用短期或隔离环境;在生产使用前审查scripts/video_gen.js(HTTPS 提交 + 轮询循环)。验证运行时是否可以读取本地图像文件并上传到 WeryAI,并在使用该路径前获得明确同意。
提示词扩展(强制)
video_gen.js 不扩展提示词。在每次 wait --json 之前,将用户的简短或模糊描述转换为完整的英文制作 prompt。
何时: 用户仅给出关键词、一行字或松散意图——或要求更丰富的视频语言。例外: 他们粘贴了一个完整的冗长提示词,在模型的 prompt_length_limit 内,并要求你不要重写;但仍需在确认表格中显示完整文本。
始终添加(视频语言): 镜头景别和角度;相机移动或固定;光线质量和动机;与 duration 节奏匹配的主体动作;为这个细分领域提供一个明确的亮点;当此技能默认为垂直时,注明 9:16 垂直。
长度: 当此文档列出所选模型键的 prompt_length_limit 时,遵守它;在删除核心动作、镜头或光线子句之前,先修剪填充性形容词。
确认: 提交前表格必须包含完整的扩展 prompt(永远不要用一行摘要)。等待用户确认或编辑。
细分领域检查清单
- 微缩世界: 浅景深、实用暖光、推轨/推近揭示;微缩景观或盒子中的房间。
- 节拍: 搭建 → 上色 → 灯光亮起或车辆经过;舒适氛围、触感材料。
- 比例提示: 必要时使用火柴、硬币或指尖作为参考。
### 示例提示词 在文件顶部仅为简短触发词——始终基于用户的实际请求进行扩展。
工作流程
- 确认用户请求符合此技能的用例(文本转视频和/或图像转视频,按文档说明)。
- 收集用户的简要描述、可选的图像 URL 和层级(最佳 / 良好 / 快速)或明确的
model键。 - 扩展提示词(强制): 除非用户提供了完整的冗长提示词并明确要求不重写,否则根据下方的
## 提示词扩展(强制)将简要描述扩展为完整的英文制作prompt。不要仅用用户的最少词汇调用 API。 - 检查扩展后的
prompt是否超出本文档冻结表格中所选模型的prompt_length_limit(如有);如果超出则缩短。 - 对照本文档冻结表格和
WERYAI_VIDEO_API.md验证duration、aspect_ratio、generate_audio、negative_prompt和其他字段。仅当所选model支持时才包含resolution(对于此技能的默认 KLING 层级,不要发送resolution——参见## 脚本与技能默认值)。 - 显示包含完整扩展
prompt的提交前参数表格;等待用户确认或编辑。 - 确认后,运行
node scripts/video_gen.js wait --json '...',使用扩展后的提示词。 - 解析 stdout JSON 并返回视频 URL;失败时,显示
errorCode/errorMessage并建议参数修复。
CLI 参考
node scripts/video_gen.js wait --json '{"model":"…","prompt":"…","duration":5,"aspect_ratio":"9:16"}'
node scripts/video_gen.js wait --json '…' --dry-run
node scripts/video_gen.js status --task-id <id>
完整参考: WERYAI_VIDEO_API.md。
完成定义
当用户从 API 响应中收到至少一个可播放的视频 URL,或收到清晰的失败解释及后续步骤时,视为完成。所使用的所有参数必须属于本文档中选定模型的允许集。提交的 prompt 必须是扩展后的制作提示词,除非用户明确提供了完整的冗长提示词并要求不重写。
边界(不在范围内)
- 不审查平台合规性、版权或肖像权;不保证输出的商业可用性。
- 不提供非 WeryAI 的离线渲染、传统编辑时间线或未在本 SKILL 或
WERYAI_VIDEO_API.md中记录的 API 字段组合。 - 不要链接到
weryai-model-capabilities.md或共享的../references/路径;使用resources/WERYAI_VIDEO_API.md获取 CLI/API 详细信息。 - 不要在技能文档中硬编码绝对路径;从技能包根目录(包含
SKILL.md的目录)运行node scripts/...,以便scripts/和resources/路径能正确解析。
示例提示词
手工制作的微型咖啡馆:最终节拍室内灯光亮起,暖光填充,慢速推近垂直画面使用这幅街景微缩模型静态图:小车经过,商店橱窗亮起基座上的上色模型,旋转展示,超浅景深微缩模型搭建揭示 9:16,舒适暖光在小房子内部亮起
默认参数
| 字段 | 值 |
|---|---|
| Model | KLING_V3_0_PRO(必须在 JSON 中作为 "model" 出现——脚本不提供默认值) |
| Aspect ratio | 9:16(固定垂直) |
| Duration | 短 (duration: 5);如需更长搭建展示则使用 10 |
| Resolution | 省略(对于 KLING 默认值,不要在 JSON 中包含该键) |
| Style | 非常浅景深、逼真材质、重点灯光强调主体道具、慢推或轻微环绕(固定) |
| Audio | 开启(环境音 + 微小道具细节音以增强沉浸感) |
API 有效性(默认
KLING_V3_0_PRO): 文本转视频duration仅 5 / 10 / 15;aspect_ratio仅 9:16, 1:1, 16:9。图像转视频aspect_ratio仅 9:16, 16:9, 1:1。无resolution字段——不要发送。 对于使用 VEO 的快速层级:文本转视频VEO_3_1_FAST,图像转视频CHATBOT_VEO_3_1_FAST,duration固定为 8,aspect_ratio仅 9:16 或 16:9。切换model_key时,遵循本节模型/API 约束和上述 API 有效性注释中的允许集;不要向不支持的模型发送resolution。
场景描述 → 微缩世界
目的: 具体的场景创意、快速视觉测试或批量调整氛围变体——无需实体模型。
输入:
场景类型(便利店 / 厨房 / 小屋 / 街角摊位 / 工作室 / 赛博场景)和氛围(温暖疗愈 / 霓虹赛博 / 白天 / 雨夜琥珀色)。如果省略氛围,选择该场景通常表现良好的光线。可选地强调搭建过程与成品展示。
提取关键道具和光线,选择能激发“我想要这个”的角度,构建提示词,显示完整参数,等待确认,然后 node scripts/video_gen.js wait --json '…'。
生成前显示完整参数;等待确认。
参数配置:
| 字段 | 值 |
|---|---|
| model | KLING_V3_0_PRO |
| aspect_ratio | 9:16 |
| duration | 5 |
| generate_audio | true |
| resolution | (省略——不为此模型发送) |
示例输入:
“夜晚的日本便利店,温暖疗愈” → 技能构建:
极端特写微距镜头,平视角度,一个手掌大小的微缩日本便利店模型放在暗色表面上,温暖的琥珀色室内光线透过微小的玻璃推拉门和霜花窗格照射出来,照亮了完美细致的内部——微型货架上摆满了拇指大小的商品包装、一个微型收银台、一个柔光箱天花板面板。相机以 30fps 极慢地向入口推近,仿佛在走近它,浅景深只让店面保持锐利,而周围的黑暗逐渐融化。冷蓝色夜晚环境填充外部,在门道处形成冷暖色分离。ASMR 柔和的氛围嗡嗡声、遥远的城市夜晚声音、微弱的店内背景音乐。
“赛博朋克工作室,霓虹” →
中近景 45 度俯拍角度,一个鞋盒大小的微缩赛博朋克工作室模型——塞满了微小的发光显示器、布满线缆的桌子、粉红色和青色的霓虹书架、在键盘前的微型动作人偶。相机以 60fps 围绕场景缓慢平滑地旋转一周,霓虹光线在每个微小的反射表面——显示器边框、咖啡杯、光泽地砖上发生折射。来自霓虹管的体积光在场景上方形成柔和的薄雾。
…
[为翻译截断]