WeryAI 视频工具 — 背景移除

该能力是自包含的（self-contained）：它仅针对用户提供的、已存在的视频 URL，完整记录并执行 background-remove 工作流。它从零开始的文生视频（text-to-video）或图生视频（image-to-video）生成任务。

入口脚本：scripts/video_background_remove.js（与本 SKILL.md 文件同级）。

运行时依赖：WERYAI_API_KEY 环境变量，Node.js 18+。

输入参数：video_url 必须为公开可访问的 https:// URL。本脚本不读取本地文件，也不执行任何文件上传流程。

本包所含内容（使用前请务必验证）

仅适用于本能力的标准目录结构如下：

• SKILL.md、eval.yaml
• scripts/video_background_remove.js（范围内可执行脚本）

若您的副本中还包含 scripts/video_gen.js、scripts/video_toolkits.js、references/WERYAI_VIDEO_API.md 或其他 CLI 工具，则这些文件本能力的契约范围——它们可能来自其他仓库同步或过度宽泛的安装。当您仅需背景移除功能时，请勿运行这些文件；建议将其删除，或从干净源重新安装。请始终审查所执行的内容：node scripts/video_background_remove.js spec。

其他工具（如多端点 CLI、本地文件上传至 growth/upload-file 类 API、CLI 中额外的环境变量等）均。本能力脚本仅依赖 WERYAI_API_KEY 和公开的 https:// URL。

API 接口定义（仅限本工具）

• 必需参数：video_url（公开 https:// URL）
• 可选参数：background_color — 可取值：TRANSPARENT、BLACK、WHITE、GRAY、RED、GREEN、BLUE、YELLOW、CYAN、MAGENTA、ORANGE
• 默认值：background_color=BLACK

在运行 node scripts/video_background_remove.js spec，可输出完整的工具 Schema（含端点地址、必填字段、默认值、枚举值等）JSON 格式。

提交前校验门禁（强制要求）

在用户明确确认视频 URL 及任何非默认的 background_color 值之前，不得执行 submit / wait 操作。付费调用不具备幂等性。

工作流说明

建议优先使用 --dry-run 验证 JSON 输入格式。使用 wait 提交任务并轮询直至完成；仅当用户明确需要获取 task_id 且不阻塞当前流程时，才使用 submit，后续通过 status 查询状态。最终结果 URL 应以 Markdown 链接形式分享，例如：[Video](https://…)。

CLI 使用方式

在执行：

node scripts/video_background_remove.js wait 
  --json '{"video_url":"https://example.com/video.mp4"}'

node scripts/video_background_remove.js submit 
  --json '{"video_url":"https://example.com/video.mp4"}'

node scripts/video_background_remove.js status --task-id 

试运行（dry-run）示例：

node scripts/video_background_remove.js wait 
  --json '{"video_url":"https://example.com/video.mp4"}' 
  --dry-run

安全性说明

切勿将 WERYAI_API_KEY 明文写入任何文件。本工作流应WERYAI_API_KEY 这一环境变量；即使兄弟脚本中误存有未文档化的环境变量，也请勿依赖。本能力范围内脚本仅读取 WERYAI_API_KEY（不读取其他环境变量）。video_background_remove.js 仅接受 https:// 协议的媒体 URL（不读取磁盘文件，不触发上传流程）。基础 URL 和轮询间隔均为脚本内硬编码常量，不由环境变量控制。

切勿传入本地文件系统路径，或运行接受此类路径的工具——除非您已明确审查并同意其上传行为。而本能力此类操作。

不适用范围（Out of scope）

• WeryAI 其他视频工具工作流（如字幕生成、画质增强、视频延长、人脸替换等）
• 从零开始的文生视频（text-to-video）或图生视频（image-to-video）

参考资料

• WeryAI llms.txt