WayinVideo - Find Moments in the Video

Polar Sponsor
爱发电 赞助
.NET 9.0

使用自然语言查询在视频中定位特定瞬间,适合在长视频中查找特定场景、主题或事件(例如,“……的那段”)

AI Find Video Moments. 此技能搜索并定位视频中的特定内容, 使用基于 WayinVideo API的自然语言查询.

功能概述

AI Find Video Moments. 此技能搜索并定位视频中的特定内容, 使用基于 WayinVideo API的自然语言查询.是一项面向实际任务的技能,主要用于Execution Workflow.;Step 0: 请检查 API 密钥. check i。

核心要点

  • 它将相关步骤、工具调用和结果整理方式集中到统一流程中,帮助使用者更快完成目标并减少重复操作。
  • 使用时应结合输入条件选择合适的执行方式,核对必要参数、依赖环境与输出内容,并按原始要求处理异常情况。
  • 从功能定位来看,该技能强调把分散的操作要求整理成清晰、可复用的处理流程,使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。

使用与执行

实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数,再依据技能说明逐步执行;若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;

结果检查与注意事项

涉及批量任务时,还应保存进度,避免中断后重复操作。该技能适合用于一次性任务,也可以接入自动化工作流,与其他技能或上层代理配合完成更完整的业务链路;在组合使用时,应明确每一步的输入输出关系,并避免不同步骤之间出现参数冲突。

AI 查找视频片段

该技能基于 WayinVideo API,通过自然语言查询在视频中搜索并定位特定内容。

执行流程

步骤 0:检查 API 密钥

检查环境变量或用户上下文中是否已配置 WAYIN_API_KEY。若缺失,请提示用户提供该密钥,或前往 https://wayin.ai/wayinvideo/api-dashboard 创建。

步骤 1:识别视频来源

判断输入是网页 URL(例如 YouTube 链接)还是本地文件路径。

[!IMPORTANT]
WayinVideo API 原生支持以下平台的直连 URL 处理:YouTube、Vimeo、Dailymotion、Kick、Twitch、TikTok、Facebook、Instagram、Zoom、Rumble、Google Drive。若平台不在上述列表中,则必须将其视为本地文件(如可能,先下载再上传)。

步骤 2:上传(仅适用于本地文件或不支持的 URL)

若输入为本地文件或来自不支持的平台,则必须先上传以获取 identity 令牌:
python3 /scripts/upload_video.py --file-path
(若输入为受支持平台的网页 URL,则跳过此步骤。)

步骤 3:搜索片段

提交视频及查询语句,以查找匹配的视频片段。可使用原始 URL 或上一步获得的 identity 令牌:
python3 /scripts/submit_task.py --url "" --query "" [options]

[!TIP]
为获得最佳效果,请确保 简洁、自包含;尽可能使用英文。

该脚本将输出 Project ID 及初始结果 JSON 文件在 workspace 中的保存路径。请务必保存这两个值,以便后续轮询结果。

可选参数:

  • --target :(可选)输出内容的目标语言。若未指定则自动检测。若指定,请务必先查阅 assets/supported_languages.md 获取正确的语言代码。
  • --name :(可选)为此任务指定自定义名称。
  • --top-k :(可选)返回最匹配的 K 个片段,默认为 10;传入 -1 表示返回所有匹配片段。
  • --export:(可选)启用视频片段渲染(返回导出链接)。
  • --ai-hook:(可选)启用自动生成的文字钩子(需配合 --export 使用)。
  • --ai-hook-style