WeryAI 视频工具 — 字幕翻译

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

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

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

输入参数：video_url 必须为可公开访问的 https:// 协议 URL；target_language 为语言代码字符串（例如 en、zh、ja）。本脚本不读取本地文件，也不执行任何文件上传流程。

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

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

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

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

其他工具（如多端点 CLI、本地文件上传至 growth/upload-file API 的流程、或这些 CLI 中额外使用的环境变量）均。本技能的脚本仅使用 WERYAI_API_KEY 和公开的 https:// URL。

API 接口（仅限本工具）

• 必需参数：video_url（公开的 https:// URL），target_language（例如 en、zh、ja、ko、fr、de、es）

在本技能根目录下运行 node scripts/video_subtitle_translate.js spec，即可以 JSON 格式输出完整的工具 Schema（含端点地址、必填字段、默认值、枚举值等）。

提交前检查门禁（强制要求）

在用户明确确认视频 URL 和 target_language 前，不得执行 submit / wait 操作。付费调用不具备幂等性。

工作流

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

CLI 使用方式

在本技能根目录下执行：

node scripts/video_subtitle_translate.js wait 
  --json '{"video_url":"https://example.com/video.mp4","target_language":"en"}'

node scripts/video_subtitle_translate.js submit 
  --json '{"video_url":"https://example.com/video.mp4","target_language":"en"}'

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

试运行（dry-run）：

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

安全性

切勿将 WERYAI_API_KEY 明文写入任何文件。请确保仅为本工作流设置 WERYAI_API_KEY；即使兄弟脚本中存在未文档化的环境变量，也请勿依赖——本技能脚本仅读取 WERYAI_API_KEY（不读取任何其他环境变量键）。video_subtitle_translate.js 仅接受 https:// 协议的媒体 URL（不读取磁盘文件，也不触发文件上传）。基础 URL 与轮询间隔均为脚本内硬编码常量，不由环境变量控制。

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

不包含的功能（Out of scope）

• 仅移除或遮盖字幕（不进行翻译）
• 仅通过文本生成全新视频

参考资料

• WeryAI llms.txt