vox-director

输入主题，自动产出 Vox 风格拼贴解说视频

vox-director 是一个自动化生成 Vox 风格纸板拼贴解说视频的开源项目。它接受一个主题，通过 Atlas Cloud 和 ffmpeg 完成从脚本撰写、视觉素材生成到最终视频合成的全流程，无需人工干预。项目本质上是 Claude Code 的一个 Agent Skill，利用大语言模型规划视频结构、生成文案，并调用图像生成工具制作拼贴元素，最后用 ffmpeg 进行剪辑和动效处理。它解决了传统解说视频制作周期长、成本高、需要专业团队的问题，让个人或小团队也能快速产出具有独特纸板美学风格的视频内容。核心能力包括自动化流程编排、多模态内容生成和视频合成，适合用于自媒体内容创作、营销广告和教学演示等场景。

开源 free 视频生成

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 2015

维护状态维护中

是否开源是

定价模式 free

项目数据

分类视频生成

开发团队Alisa0808

所属国家

官网地址

GitHubhttps://github.com/Alisa0808/vox-director

定价模式free

价格说明开源项目，MIT 许可证，可免费使用和部署。

访问状态

是否开源是

开源协议MIT

主要语言Python

技术栈/模型ai,ai-video,claude-code,claude-skill,collage-video,dsh-plugin,explainer-video,ffmpeg,generative-ai,llm,motion-graphics,python,text-to-video,tts,video,video-generation,vox

GitHub 星标★ 2015

30天Star增速

HF 下载量

上线时间2026-07-10 00:00:00

最近更新2026-09-23 00:00:00

维护状态维护中

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数1

使用教程

难度：入门约 10 分钟部署方式：命令行工具 6 步

环境要求

一个可读取工作流并执行脚本的编码 Agent（如 Claude Code、Codex 等）
Atlas Cloud API Key（用于脚本、图像、语音、音乐等生成）
本地已安装 ffmpeg（用于最终视频合成与动效处理）

安装与启动步骤

1克隆技能仓库

把仓库直接克隆到 Claude Code 的技能目录下，Claude Code 会自动发现并识别该 skill。
```
git clone https://github.com/Alisa0808/vox-director.git ~/.claude/skills/vox-director
```
2配置 Atlas Cloud 密钥

到 Atlas Cloud 控制台创建 API Key，然后设置为环境变量，供技能调用生成接口时使用。
```
export ATLASCLOUD_API_KEY="sk-xxxxxxxx"
```
3确认本地 ffmpeg

README 明确要求依赖本地 ffmpeg 完成剪辑与动效合成，先确认命令可用再开始生成。
```
ffmpeg -version
```
4让 Agent 生成视频

用自然语言向已安装技能的 Agent 描述主题、语言、画幅和时长，Agent 会先给出节奏表供确认。
```
Make me a Vox-style collage video introducing Mexican street food — English, 16:9, 15 seconds.
```
5选取风格与出片

Agent 会先跑一轮风格方案供你挑选，确认后依次生成关键帧、动效、配音和音乐并合成视频。
6查看输出文件

成片会写入项目目录下的 out//final.mp4，直接播放检查即可。

关键配置

配置项	必填	说明	示例
`ATLASCLOUD_API_KEY`	是	调用 Atlas Cloud 生成能力的密钥，技能全流程依赖它	`sk-xxxxxxxx`

如何确认成功

Agent 流程跑完后，在 out//final.mp4 能找到可正常播放的成片，即表示部署与生成成功。

常见问题

Q：没有 Claude Code 可以用吗？

A：可以。这是 agent skill，任何能读取工作流并执行脚本的编码 Agent 都能用，其他 Agent 按 AGENTS.md → SKILL.md 的指引接入。

Q：不想克隆仓库怎么安装？

A：下载打包好的 vox-director.skill 文件，通过 Claude 的 skills 管理界面导入安装即可。

Q：API Key 到哪里申请？

A：在 atlascloud.ai/console/api-keys 控制台创建，然后 export 为 ATLASCLOUD_API_KEY 环境变量。

Q：会直接开始出片吗？

A：不会。Agent 先给出 beat map 让你确认，再跑风格方案供你挑选，之后才生成素材并合成视频。

Q：生成结果放在哪里？

A：默认输出在项目的 out// 目录下，成片文件名为 final.mp4。

注意事项

安装路径 ~/.claude/skills/vox-director 是 README 给出的 Claude Code 技能目录，其他 Agent 需按对应文档放置。
API Key 请替换 sk-xxxxxxxx 为真实密钥，避免泄露到公开仓库。
项目依赖本地 ffmpeg，未安装会导致最终合成步骤失败。
流程包含人工确认环节（节奏表、风格方案），并非完全无人值守的一次性生成。

核心亮点

端到端自动化，从主题到成片无需人工剪辑
复刻 Vox 标志性纸板拼贴风格，视觉辨识度高
基于 Claude Skill 架构，易于集成到现有 AI 工作流

不足之处

依赖 Atlas Cloud 和 ffmpeg，本地部署门槛较高
视频风格单一，仅限纸板拼贴，不适用于写实或 3D 风格

适用场景

自媒体创作者快速生成知识解说视频
广告营销团队制作低成本拼贴风格宣传片
教育机构制作生动有趣的教学演示内容

替代项目

Pika、Runway Gen-2、D-ID

项目介绍

vox-director 是视频领域的开源项目，由 Alisa0808 开发，是 2026 年新上线的项目。

在全站 13,090 个收录项目中，它的 GitHub 星标数（2,015）位列前 30%，在视频分类的 473 个项目里位列前 12%。

近 42 天，它的 GitHub 星标从 1,273 增加到 2,015，净增 742。

项目仍在小幅维护中，最近一次代码更新于 2026-09-23。MIT 许可证，可免费使用和部署。

它主要面向的使用场景是：自媒体创作者快速生成知识解说视频。同类可对比的替代方案包括 Pika、Runway Gen-2、D-ID。

上一篇：ai-fusion-video

下一篇：LocalMiniDrama