SuperAPI AI 工具集

jianying-editor

设计与创作

查看项目

更新于 10-27 16:20

技能介绍

用途

JianYing Editor Skill 是一个面向剪映专业版(JianYing Pro)的 AI 自动化剪辑高级封装 API。当用户希望自动化视频剪辑、生成草稿或操作媒体素材时,可使用该技能。它通过 Python 脚本与命令行工具,把剪映中的常见剪辑操作封装为可编程调用的能力。

主要能力

  • 素材与媒体:导入素材、云端视频与云端音乐组合、AI 视频分析优化(30m/360p)。
  • 文本与字幕:添加字幕、文本与说明文字,支持旁白与字幕对齐。
  • 动画与效果:添加关键帧动画;按中英文名称检索并应用滤镜、特效与转场。
  • 录屏与变焦:屏幕录制与智能变焦自动化(Windows 使用 tools/recording/recorder.py,macOS 使用 tools/recording/macos_recorder.py)。
  • Web 动效合成:Web-to-Video 生成(HTML 动画转为时间线片段)。
  • 音频与配音:TTS 配音与 BGM 选取,支持从剪映 App 同步收藏/播放过的 BGM。
  • 项目与导出:草稿管理、保存、导出;支持无头导出为 MP4/SRT,可指定分辨率与帧率。
  • 模板处理:安全克隆模板并批量替换物料,避免损坏原模板。
  • 生成式剪辑:提供生成式剪辑的思维链规则,以及影视解说生成(由 storyboard JSON 生成 60 秒解说视频)。

使用方式

技能以规则文件、脚本与示例组织:

  • 规则文件位于 rules/ 目录,包括 setup.md(所有脚本的强制初始化代码)、core.md(保存、导出与草稿管理)、cli.md(CLI 契约与机器可读输出约定)、media.md(素材导入与 AI 视频分析优化)、text.md(字幕、文本与说明文字)、keyframes.md(关键帧动画)、effects.md(滤镜、特效与转场检索应用)、recording.md(录屏与智能变焦)、web-vfx.md(Web-to-Video 生成)、generative.md(生成式剪辑思维链)、audio-voice.md(TTS 配音与 BGM 来源)。
  • 常用命令示例:
    • 草稿检查:python <SKILL_ROOT>/scripts/draft_inspector.py list --limit 20;summary --name "DraftName";show --name "DraftName" --kind content --json
    • 素材检索:python <SKILL_ROOT>/scripts/asset_search.py "复古" -c filters
    • 影视解说生成:python <SKILL_ROOT>/scripts/movie_commentary_builder.py --video "video.mp4" --json "storyboard.json"
    • 同步剪映原生素材:python <SKILL_ROOT>/scripts/sync_jy_assets.py
    • 录屏与智能变焦:python <SKILL_ROOT>/tools/recording/recorder.py;或 python <SKILL_ROOT>/scripts/jy_wrapper.py apply-zoom --name "Project" --video "v.mp4" --json "e.json"
    • 自动导出:python <SKILL_ROOT>/scripts/auto_exporter.py "DraftName" "output.mp4" --res 1080 --fps 60;仅导出 SRT:python <SKILL_ROOT>/scripts/jy_wrapper.py export-srt --name "DraftName"
    • 模板克隆:python <SKILL_ROOT>/scripts/jy_wrapper.py clone --template "酒店模板" --name "客户A_副本"
    • 环境诊断:python <SKILL_ROOT>/scripts/api_validator.py
  • 快速开始示例(节选):初始化环境后,通过 from jy_wrapper import JyProject 创建项目,使用 project.add_media_safe 导入视频与配乐,使用 project.add_text_simple 添加带动画的标题,最后 project.save()。初始化 JyProject 时应根据主视频素材比例设置分辨率,默认横屏 1920x1080。
  • 示例文件位于 examples/ 目录,包括 my_first_vlog.py、simple_clip_demo.py、compound_clip_demo.py、cloud_video_music_tts_demo.py、web_to_video_intro_demo.py、robust_auto_export.py、auto_exposure_align_demo.py、video_transcribe_and_match.py 等,覆盖从基础剪辑到 AI 驱动工作流的完整流程。
  • 提示词模板位于 prompts/ 目录,例如 readme_to_tutorial.md 可将项目 README.md 转为完整安装教程视频脚本(将内容注入 {{README_CONTENT}} 变量)。

适用场景

  • 批量或自动化生成剪映草稿与视频项目。
  • 录屏教程制作并自动应用缩放关键帧。
  • 云端视频 + 云端 BGM + TTS 配音与字幕对齐。
  • 影视解说类短视频生成。
  • 模板化项目克隆与物料批量替换。
  • 无头批量导出 MP4 或 SRT。

限制与规范

  • 脚本位置:禁止在 Skill 内部目录创建剪辑脚本;所有剪辑逻辑实现代码(.py 脚本)必须存放在用户当前项目的根目录或其子目录(如 scripts/),以保持 Skill 库纯净和可移植。
  • 配乐选择:简单演示可使用默认音乐;实际项目应优先检索并推荐 data/cloud_music_library.csv 中的相关曲目,或按视频主题(如“科技”“温暖”)进行关键词过滤,并向用户确认。
  • 初始化:所有脚本需遵循 rules/setup.md 的强制初始化代码;JyProject 初始化时需按主视频素材比例设置分辨率。
  • 关于收费、价格、平台支持范围、具体效果等事实,资料中暂未提供。