
rea-video
逐镜拆解任意视频,告诉你它怎么拍的、怎么复刻
项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-11-07 · 当前星标 ★ 2778
使用教程
环境要求
- Python 3.10 及以上
- ffmpeg(用于抽帧与音轨处理)
- 可执行命令的编码智能体,如 Claude Code 或 Codex
- 可选:支持视频的模型服务地址与密钥(Gemini 或 Doubao)
安装与启动步骤
-
1安装 ffmpeg
抽帧和提取音轨依赖 ffmpeg。macOS 用 brew 安装,Debian/Ubuntu 改用 sudo apt install ffmpeg。
brew install ffmpeg -
2克隆项目仓库
拉取源码并进入项目目录,后续安装脚本需在仓库根目录执行。
git clone https://github.com/JuneYaooo/rea-video && cd rea-video -
3运行安装脚本
脚本安装 CLI 并把技能链接到 ~/.claude、~/.codex、~/.agents;pip 受限时自动改用 pipx 或本地 .venv。
bash scripts/install_skill.sh -
4验证命令可用
执行帮助命令,确认 rea-video 已加入 PATH 并能正常输出用法。
rea-video --help -
5接入视频模型
可选步骤。把模型服务地址和密钥交给智能体,Gemini 或 Doubao 均可,可提升镜头来源判定与提示词反推准确度。
-
6分析目标视频
在 Claude Code、Codex 等智能体中下达指令,把示例路径换成你的视频真实路径。
Install https://github.com/JuneYaooo/rea-video, then break down this video: /path/to/video.mp4
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
模型服务地址(endpoint) | 否 | 视频模型接口地址,供智能体调用以判断镜头来源并反推提示词 | https://your-endpoint.example.com/v1 |
模型 API Key | 否 | 调用上述模型接口所需的密钥,交给智能体保管使用 | sk-xxxxxxxx |
如何确认成功
执行 rea-video --help 能正常打印用法说明,即表示 CLI 安装成功。
常见问题
Q:pip 安装被限制怎么办?
A:README 说明安装脚本会自行改用 pipx 或创建本地 .venv 完成安装,直接运行脚本即可。
Q:不接入视频模型还能用吗?
A:可以。未配置模型时流程仍能跑通,若智能体能读图,会自行复核不确定的镜头。
Q:报告用什么语言输出?
A:按提问语言输出,智能体通过 --lang 参数传递中文或英文,示例报告为英文。
Q:最终会得到什么结果?
A:一句话总结、按拍摄/生成/编码拆分的复刻方案,以及含逐镜画面、证据、提示词的 report.html。
注意事项
- README 中的 /path/to/video.mp4 需替换为本地视频的真实路径。
- 安装脚本会把技能链接到 ~/.claude、~/.codex、~/.agents 三个目录。
- 详细文档目前以中文为主,智能体读取后可用你使用的语言作答。
核心亮点
- 按镜头粒度分析,而非整片笼统判断,定位更精确
- 同时覆盖实拍、AI 生成、代码渲染三类来源,适配当下混合制作流程
- 输出不止于识别,还给出可操作的复刻方案与提示词参考
不足之处
- 依赖视觉模型判断,对低画质、强后期或混合素材的镜头易误判
- 逐镜分析需大量抽帧与模型调用,长视频耗时与成本较高
- 项目较新,复刻方案的实际可执行性缺少大规模验证
适用场景
- 拆解爆款短视频的镜头语言与剪辑节奏,用于创作学习
- 鉴别一段素材是实拍还是 AI 生成,辅助内容审核
- 为已有视频反推生成提示词与制作流程,快速复刻同款
替代项目
Hive AI Detector、Sensity AI、ffmpeg
同类项目推荐
autoshorts
开源
游戏录像一键变竖屏爆款短视频,自动剪高光加配音
Automatically generate viral-ready vertical short clips from long-form gameplay foot···
VideoClaw
开源
一句话创意,自动生成完整影片,让 AI 当你的视频员工。
AI 全自动化视频生成员工 | Your First AIGC Coworker. Chat an Idea. Get a Film.
YUME
开源
用世界模型实时生成可交互视频,从文本或图片秒变动态画面。
The official code of Yume
AIEV
开源
上传素材,AI 自动剪辑出带动态字幕的成品视频
Automatic AI video editing. Claude directs HyperFrames (HTML + GSAP motion graphics)···
FateZero
开源
一句话描述视频,零训练实现风格统一编辑
[ICCV 2023 Oral] "FateZero: Fusing Attentions for Zero-shot Text-based Video Editing···
AnimateAnyMesh
开源
输入文本和网格,一键生成动态 4D 动画,告别手工绑定。
[ICCV 2025] Official code for AnimateAnyMesh: A Feed-Forward 4D Foundation Model for···
UltraFlash
开源
实时流式生成高分辨率视频
⚡ Ultra Flash: Scaling Real-Time Streaming Video Generation to High Resolutions
pyvideotrans
开源
上传视频,一键生成多语言配音和字幕,轻松出海。
Translate the video from one language to another and embed dubbing & subtitles.
kinetograph
开源
用代码和代理快速批量生成视频
A blazingly fast programmatic video engine, made for agents.