Short Video Maker

🚀 短視頻生成工具

短視頻生成工具是一款開源的自動化視頻製作工具，它能依據簡單的文本輸入，生成高質量的短視頻。該工具集成了文字轉語音（TTS）、語音識別、背景視頻選擇和音樂配搭等多種先進技術，為用戶帶來便捷的視頻製作體驗。

✨ 主要特性

1. 文字轉語音：藉助Kokoro TTS，可將文本轉換為自然流暢的語音。
2. 語音識別：通過Whisper CPP，能夠生成準確的文字字幕。
3. 背景視頻選取：可從Pexels平臺挑選與內容相關的高質量視頻片段。
4. 視頻合成：利用Remotion框架完成視頻元素的編排和渲染，輸出專業級視頻。

📦 安裝指南

安裝要求

• 硬件配置：
  • CPU：建議雙核及以上
  • 內存：至少4GB RAM
  • 硬盤空間：需預留至少10GB，用於存儲生成的視頻和臨時文件
• 軟件依賴：
  • Node.js（推薦版本：LTS）
  • FFmpeg（版本要求：>=2.1.3）
  • Pexels API密鑰

運行方式

方式一：使用NPX命令行工具

直接運行以下命令即可啟動服務：

npx short-video-maker

方式二：基於Docker部署

構建並運行Docker容器：

docker build -t short-video-maker .
docker run -p 3123:3123 short-video-maker

💻 使用示例

基礎用法

請求示例

{
  "scenes": [
    {
      "text": "歡迎來到短視頻生成器，讓我們一起探索人工智能的無限可能",
      "searchTerms": ["科技","未來"]
    }
  ],
  "config": {
    "paddingBack": 3000,
    "music": "科幻"
  }
}

請求方式

通過Postman或curl工具發送POST請求：

curl -X POST http://localhost:3123/api/short-video \
-H "Content-Type: application/json" \
-d '{"scenes":[{"text":"示例文本","searchTerms":["關鍵詞"]],"config":{"paddingBack":3000,"music":"類型"}}'

📚 詳細文檔

環境變量配置

在項目根目錄創建.env文件，添加以下配置項：

• PORT=3123（可選，默認為3123）
• PEXELS_API_KEY=your_api_key
• WHISPER_MODEL=model_name

項目架構

• 前端：基於React構建的可視化編輯界面（即將發佈）
• 後端：使用Node.js開發RESTful API
• 核心模塊：
  • 視頻生成器：負責視頻合成與渲染
  • 字幕生成器：提供高精度語音識別功能
  • 資源管理器：實現Pexels視頻資源的高效管理和調度

接口文檔

REST API

1. GET /api/short-video/:id：獲取指定ID的視頻文件
2. POST /api/short-video：創建新視頻（支持批量處理）
3. DELETE /api/short-video/:id：刪除指定視頻文件
4. GET /api/music-tags：獲取可用音樂標籤列表

MCP協議

• GET /mcp/sse：訂閱即時事件流
• POST /mcp/messages：發送控制指令到MCP服務器

📄 許可證

本項目遵循MIT License開源協議，詳細信息請見LICENSE文件。

致謝

感謝以下項目的貢獻：

• Remotion：提供強大的視頻生成框架
• Whisper.cpp：優秀的語音識別工具
• Pexels：豐富的視頻資源庫
• FFmpeg：功能強大的音視頻處理工具
• Kokoro.js：先進的TTS引擎