🚀🎬 ShortGPT

人工智能视频自动化框架

请按照以下安装步骤在本地运行Web应用（强烈推荐使用Google Colab）。更多详细信息请阅读“installation-notes.md”。

🎥 展示（完整视频请见YouTube）

https://github.com/RayVentura/ShortGPT/assets/121462835/a802faad-0fd7-4fcb-aa82-6365c27ea5fe

🎥 配音

https://github.com/RayVentura/ShortGPT/assets/121462835/06f51b2d-f8b1-4a23-b299-55e0e18902ef

🌟 表达支持

我们希望ShortGPT能对您有所帮助！如果您觉得有用，请在仓库上给我们点个赞⭐。非常简单，只需点击页面右上角的“Star”按钮即可。您的支持对我们意义重大，也将激励我们不断改进和扩展ShortGPT的功能。感谢您的支持，祝您创作愉快！🎉

🛠️ 工作原理

📝 ShortGPT简介

ShortGPT是一个强大的内容自动化框架，能够简化视频制作、素材获取、语音合成及编辑等流程。其最常见的应用场景包括YouTube自动化和TikTok创意内容程序化生成。

• 🎞️ 自动化编辑框架：通过面向大语言模型的视频编辑语言， streamline视频制作流程。

• 📃 脚本与提示词：提供多种预设脚本和提示词，适用于不同的LLM自动化编辑场景。

• 🗣️ 配音/内容创作：支持多语言，包括英语🇺🇸、西班牙语🇪🇸、阿拉伯语🇦🇪、法语🇫🇷、波兰语🇵🇱、德语🇩🇪、意大利语🇮🇹、葡萄牙语🇵🇹、俄语🇷🇺、中文🇨🇳、日语🇯🇵、印地语🇮🇳、韩语🇰🇷等超过30种语言（借助EdgeTTS实现）。

• 🔗 字幕生成：自动为视频生成字幕。

• 🌐🎥 素材获取：从互联网及Pexels API等渠道获取图片和视频素材。

• 🧠 记忆与持久化：利用TinyDB确保自动化编辑变量的长期持久化。

🚀 快速入门：在Google Colab上运行ShortGPT（https://colab.research.google.com/drive/1_2UKdpF6lqxCqWaAcZb3rwMVQqtbisdE?usp=sharing）

如果您不想在本地系统上安装相关依赖，可以使用Google Colab笔记本。该方式免费且无需任何安装配置。

1. 点击Google Colab笔记本链接：https://colab.research.google.com/drive/1_2UKdpF6lqxCqWaAcZb3rwMVQqtbisdE?usp=sharing

2. 进入笔记本后，只需按顺序从上到下运行各个代码单元格。您可以点击每个单元格并按下“Play”按钮，或直接使用键盘操作。尽情享受ShortGPT带来的便利吧！

在本地运行ShortGPT的说明

本指南提供了安装ShortGPT及其依赖项的分步指导。要在本地运行ShortGPT，您需要Docker。

安装步骤

要运行ShortGPT，您需要先安装Docker。更多详细信息请参阅“installation-notes.md”。

1. 运行Dockerfile：

docker build -t short_gpt_docker:latest .
docker run -p 31415:31415 --env-file .env short_gpt_docker:latest

运行runShortGPT.py Web界面

2. 脚本运行完成后，Gradio界面应在本地主机的31415端口打开（http://localhost:31415）。

框架概述

• 🎬 ContentShortEngine专为短视频创作设计，涵盖从脚本生成到最终渲染的全流程，还包括添加YouTube元数据等功能。

• 🎥 ContentVideoEngine则更适合长视频制作，负责音频生成、背景视频素材自动采集、字幕定时以及背景素材准备等工作。

• 🗣️ ContentTranslationEngine用于对整部视频进行配音和翻译，覆盖主流语言及更多特定目标语言。它接收视频文件或YouTube链接，转录音频内容，翻译文本，以目标语言配音，并添加字幕，最终输出完全不同语言的新视频。

• 🎞️ 自动化EditingEngine采用编辑标记语言和JSON格式，将编辑过程拆解为易于管理且可定制的模块，便于大型语言模型理解和处理。

💡 ShortGPT提供丰富的自定义选项，满足您的需求，从语言选择到水印添加均可灵活调整。

🔧 作为一款框架，ShortGPT具有高度的适应性和灵活性，能够高效、创造性地完成内容创作任务。

更多文档即将发布，请耐心等待。

使用的技术

ShortGPT 采用以下技术来支持其功能：

• Moviepy: Moviepy 用于视频编辑，使 ShortGPT 能够进行视频剪辑和渲染。

• OpenAI: OpenAI 用于自动化整个流程，包括生成用于 LLM 自动化编辑的脚本和提示。

• ElevenLabs: ElevenLabs 用于语音合成，支持多种语言的配音制作。

• EdgeTTS: 微软提供的免费 EdgeTTS 也用于语音合成，支持的语言数量远超 ElevenLabs 目前的能力。

• Pexels: Pexels 用于获取背景素材，使 ShortGPT 能够连接网络并访问丰富的图片和视频资源。

• 必应图片: 必应图片用于获取图像，为 ShortGPT 提供了一个全面的数据库，以便检索相关视觉内容。

这些技术协同工作，为使用 AI 自动化制作视频和短视频内容提供了流畅高效的体验。

💁 贡献

作为一个处于快速发展的开源项目，我们非常欢迎各种形式的贡献，无论是新增功能、改进基础设施，还是完善文档。

ShortGPT 快速上手指南

ShortGPT 是一个强大的 AI 视频自动化框架，旨在简化短视频创作、素材搜集、配音合成及编辑流程。它支持包括中文在内的 30 多种语言，适用于 YouTube 自动化和 TikTok 创意项目。

环境准备

在开始之前，请确保您的系统满足以下要求：

• 操作系统：Linux, macOS 或 Windows (需安装 Docker Desktop)
• 核心依赖：必须安装 Docker。ShortGPT 推荐通过 Docker 容器运行以避免本地环境配置冲突。
• 网络环境：由于项目依赖 OpenAI、ElevenLabs、Pexels 等海外服务，请确保您的网络环境可以正常访问这些 API。
• API Keys：准备以下服务的密钥（根据需求选择）：
  • OpenAI API Key (用于脚本生成和逻辑控制)
  • ElevenLabs API Key 或 使用内置免费的 EdgeTTS (用于语音合成)
  • Pexels API Key (用于素材搜集)
  • Bing Image API (可选，用于图片搜集)

注意：虽然项目提供了 Google Colab 版本供免安装体验，但本指南专注于本地 Docker 部署方案，以获得更稳定的长期运行环境。

安装步骤

ShortGPT 推荐使用 Docker 进行部署。请按照以下步骤操作：

1. 克隆项目代码 打开终端，克隆 ShortGPT 仓库到本地：

   git clone https://github.com/RayVentura/ShortGPT.git
   cd ShortGPT
   

2. 配置环境变量 在项目根目录下创建 .env 文件，并填入您的 API 密钥。参考格式如下：

   OPENAI_API_KEY=your_openai_key_here
   ELEVENLABS_API_KEY=your_elevenlabs_key_here
   PEXELS_API_KEY=your_pexels_key_here
   # 如果只使用 EdgeTTS，可不填 ElevenLabs Key
   

3. 构建并运行 Docker 容器 执行以下命令构建镜像并启动服务：

   docker build -t short_gpt_docker:latest .
   docker run -p 31415:31415 --env-file .env short_gpt_docker:latest
   

   • -p 31415:31415：将容器的 31415 端口映射到本地。
   • --env-file .env：加载您刚才配置的密钥文件。

基本使用

启动成功后，ShortGPT 会自动运行一个基于 Gradio 的 Web 交互界面。

1. 访问界面 打开浏览器，访问地址：

   http://localhost:31415
   

2. 创建视频 在 Web 界面中，您可以直接使用可视化的表单进行操作：

   • 选择引擎：
     • ContentShortEngine：用于制作短视频（Shorts/Reels/TikTok），自动处理脚本、配音、字幕和素材。
     • ContentVideoEngine：用于较长视频，侧重背景素材匹配和音频同步。
     • ContentTranslationEngine：用于视频翻译和配音（例如将英文视频自动译为中文并重新配音）。
   • 输入主题：在提示框中输入视频主题（例如：“介绍中国古代四大发明”）。
   • 配置参数：选择目标语言（支持中文 🇨🇳）、语音类型、视频时长等。
   • 生成：点击生成按钮，系统将自动执行脚本编写、素材搜索、配音合成、字幕添加及最终渲染。

3. 获取结果 处理完成后，界面将提供生成的视频文件下载链接，您可以直接保存或在本地预览。

---

更多高级功能（如自定义编辑标记语言、持久化存储配置）请参考项目官方文档。