Videocutter

🚀 VideoCutter 用戶使用指南

VideoCutter 是一款專業的多媒體處理工具，它集成了視頻、音頻、圖像處理模塊。藉助先進的 AI 技術和強大的引擎，深度支持 MCP 智能體協議，允許 AI 智能體通過自然語言調用功能，並以 SSE 和 HTTP Streamable 雙模式運行，為短視頻等內容創作提供一站式、智能化的編輯解決方案。

✨ 主要特性

🌟 核心優勢

• 🎯 一站式處理：集成視頻、音頻、圖像三大處理模塊，滿足所有媒體編輯需求。
• ⚡ 高性能處理：支持硬件加速，大幅提升處理速度和效率。
• 🤖 AI 智能優化：內置多種 AI 模型，提供智能文本生成、圖像生成、視頻生成能力。
• 🎨 AI 創作工具：支持文生圖、文生視頻、圖片轉視頻等 AI 創作功能。
• 🧠 智能處理：具備智能變速、智能場景檢測、語音識別、字幕提取等 AI 輔助功能。
• 🤖 MCP 智能體：深度支持 AI 智能體，提供自然語言調用和智能工作流能力，支持 SSE 和 HTTP Streamable 雙模式。
• 🔌 多接口支持：提供 REST API 和 MCP 協議，支持各種集成方式。
• 📱 跨平臺兼容：支持 Windows、macOS、Linux 等主流操作系統。
• 🎯 精確定位：支持 81 宮格精確定位系統，提供像素級精確控制。
• 📦 批量處理：支持批量圖片疊加、文字疊加等高效批量操作。

無論是個人創作者、內容製作團隊，還是企業用戶，都能通過 VideoCutter 輕鬆完成複雜的媒體處理任務。

🤖 MCP 智能體支持

VideoCutter 深度集成 Model Context Protocol (MCP) 協議，為 AI 智能體提供強大的媒體處理能力。

MCP 傳輸模式

• SSE 模式：Server - Sent Events 模式，支持實時流式數據傳輸。
  • 服務器地址：http://localhost:8000/mcp/sse
  • 特點：單向實時推送，適合進度監控和狀態更新。
  • 應用場景：長時間處理任務的實時反饋。
• HTTP Streamable 模式：HTTP 流式傳輸模式，支持雙向流式通信。
  • 服務器地址：http://localhost:8001/mcp/streamable
  • 特點：雙向流式通信，支持實時交互。
  • 應用場景：需要實時交互的複雜工作流。

AI 智能體能力

通過 MCP 協議，AI 智能體可以：

• 自然語言調用：使用自然語言描述需求，AI 智能體自動調用相應的媒體處理功能。
• 智能工作流：AI 智能體可以組合多個處理步驟，創建複雜的媒體處理工作流。
• 實時協作：支持 AI 智能體與用戶實時協作，根據用戶反饋調整處理策略。
• 上下文理解：AI 智能體能夠理解媒體內容的上下文，提供更精準的處理建議。
• 自動化創作：從內容規劃到最終輸出，AI 智能體可以全流程自動化處理。
• 流式響應：支持實時進度反饋和結果流式傳輸，提升用戶體驗。

🔗 多接口生態

VideoCutter 構建了完整的多接口生態系統：

• REST API：為傳統應用和 Web 服務提供標準化的 HTTP 接口。
• MCP 協議：為 AI 智能體和 AI 應用提供專門的協議支持。
  • SSE 模式：實時流式數據傳輸，適合進度監控。
  • HTTP Streamable 模式：雙向流式通信，支持實時交互。
• 本地部署：支持完全本地化部署，保護數據隱私。
• 雲端服務：支持雲端 AI 模型服務，提供強大算力。
• 插件擴展：支持第三方插件和自定義功能擴展。

🚀 產品亮點

1. 強大的視頻處理能力

基礎編輯功能

• 視頻分割：精確到毫秒的視頻分割，支持指定時間範圍。
• 視頻合併：多視頻文件智能合併，自動處理格式兼容。
• 視頻變速：0.1 - 16 倍速調節，保持音視頻同步。
• 視頻倒放：完整的時間軸倒序播放。
• 視頻旋轉：任意角度旋轉，自動調整輸出尺寸。
• 視頻裁剪：精確的像素級區域裁剪。
• 視頻縮放：智能尺寸調整，保持畫面比例。
• 視頻填充：為視頻添加邊框和填充效果。

視頻特效功能

• 視頻濾鏡：黑白、棕褐色、復古、模糊等多種藝術濾鏡。
• 顏色調色：亮度、對比度、飽和度、伽馬值精細調節。
• 視頻銳化：增強畫面細節和清晰度。
• 馬賽克處理：對指定區域添加馬賽克效果。
• 智能變速：基於內容相似度的智能加速播放。
• 智能場景檢測：自動識別視頻場景變化點。

疊加合成功能

• 視頻疊加：在主視頻上疊加另一個視頻。
• 圖片疊加：在視頻上疊加靜態圖片，支持 81 宮格精確定位。
• 文字疊加：在視頻上添加文字水印和字幕，支持多種字體和效果。
• 音頻疊加：在視頻上疊加音頻軌道。
• 音視頻分離：將視頻中的音頻和視頻軌道分離。
• 批量疊加：支持通過命令文件批量添加圖片和文字水印。

格式轉換功能

• 視頻轉 GIF：將視頻轉換為 GIF 動畫。
• 獲取視頻幀：從指定時間點提取單幀圖像。

2. 專業的音頻處理

基礎音頻編輯

• 音頻分割：毫秒級音頻分割，支持指定時間範圍。
• 音頻合併：多音頻文件無縫合並。
• 音頻變速：保持音質的變速處理。
• 音頻倒放：完整的時間軸倒序播放。
• 音量調節：精確的音量控制和標準化。

音頻增強效果

• 音頻標準化：將音頻音量標準化到標準水平。
• 淡入淡出：為音頻添加平滑的淡入淡出效果。
• 混響效果：模擬不同空間環境的聲學效果。
• 音頻壓縮器：專業級動態範圍壓縮。
• 人聲增強：突出人聲，提升清晰度。
• 音頻混音：將多個音頻混合為單一軌道。

高級功能

• 音頻循環：創建循環播放音頻。
• 音頻格式轉換：支持所有主流音頻格式互轉。
• 字幕提取：從音頻中自動提取字幕文本。
• 文字轉語音：支持 CosyVoice 預訓練和語音克隆模式。
• 獲取音頻信息：獲取音頻文件的詳細信息。

3. 全面的圖像處理

基礎圖像編輯

• 圖像裁剪：精確的像素級裁剪控制。
• 圖像旋轉：任意角度旋轉和鏡像翻轉。
• 圖像縮放：保持比例的智能尺寸調整。
• 圖像翻轉：水平和垂直翻轉。
• 亮度調整：精確的亮度控制。
• 對比度調整：增強明暗差異。
• 飽和度調整：色彩飽和度控制。

圖像特效

• 圖像濾鏡：黑白、復古、模糊、銳化等多種效果。
• 噪點效果：添加各種類型的噪點效果。
• 暗角效果：營造專業攝影氛圍。
• 圖像銳化：增強圖像細節和清晰度。
• 馬賽克處理：對指定區域添加馬賽克效果。

圖像合成

• 圖片疊加（絕對位置）：在指定座標位置疊加圖片。
• 圖片疊加（相對位置）：使用相對位置疊加圖片，支持 81 宮格精確定位。
• 文字疊加（絕對位置）：在指定座標位置添加文字。
• 文字疊加（相對位置）：使用相對位置添加文字，支持多種字體和效果。
• 拼貼製作：多圖拼貼和網格佈局。
• 批量疊加：支持通過命令文件批量疊加圖片和文字，提高處理效率。

格式轉換功能

• 圖片轉視頻：將靜態圖片轉換為視頻。
• 多圖轉 GIF：將多張圖片合成為 GIF 動畫。
• 圖像格式轉換：支持所有主流圖像格式互轉。
• 水印去除：智能去除圖像中的水印。
• 美顏處理：簡單的人臉美顏效果。
• 圖像縮略圖：生成指定尺寸的縮略圖。
• 獲取圖像信息：獲取圖像文件的詳細信息。

4. 強大的 AI 智能功能

AI 模型服務

• 多模型支持：集成 Ollama、豆包、硅基流動等主流 AI 服務提供商。
• 本地部署：支持 Ollama 本地模型，保護數據隱私。
• 雲端服務：支持豆包、硅基流動等雲端 AI 服務，提供強大算力。
• 靈活配置：可根據需求啟用或禁用不同的 AI 服務提供商。
• MCP 集成：通過 MCP 協議為 AI 智能體提供 67 個專業工具。

文本生成功能

• 智能文本生成：基於提示詞生成高質量文本內容。
• 多語言支持：支持中文、英文等多種語言文本生成。
• 參數調節：支持溫度、最大長度等參數精細調節。
• 分段內容生成：自動生成視頻分段描述和對應字幕文本。

圖像生成功能

• 文生圖：根據文字描述生成高質量圖像。
• 多尺寸支持：支持 512x512 到 2048x2048 等多種分辨率。
• 多比例支持：支持 1:1、4:3、16:9、9:16 等多種寬高比。
• 藝術風格：支持多種藝術風格和創作風格。

視頻生成功能

• 文生視頻：根據文字描述生成動態視頻內容。
• 圖片轉視頻：將靜態圖片轉換為動態視頻。
• 多分辨率支持：支持 480p、720p、1080p 等多種分辨率。
• 時長控制：支持 3 - 12 秒的視頻時長調節。
• 動作描述：通過文字描述控制視頻中的動作和變化。

智能處理功能

• 智能變速：基於內容相似度自動檢測並加速重複片段。
• 智能場景檢測：自動識別視頻場景變化點，便於精確剪輯。
• 語音識別：從視頻中自動提取字幕文本。
• 人聲增強：智能增強音頻中的人聲部分。
• 音頻降噪：自動去除音頻中的背景噪音。

AI 輔助創作

• 內容規劃：AI 幫助規劃視頻內容結構和分段。
• 字幕生成：自動生成與視頻內容匹配的字幕文本。
• 創意建議：基於主題提供創作靈感和建議。
• 質量優化：AI 輔助優化視頻、音頻、圖像質量。

MCP 智能體集成

• 自然語言交互：通過自然語言與 AI 智能體交互，完成複雜的媒體處理任務。
• 智能工作流：AI 智能體可以自動組合多個處理步驟，創建端到端的處理流程。
• 上下文感知：AI 智能體能夠理解媒體內容的上下文，提供更精準的處理建議。
• 實時協作：支持 AI 智能體與用戶實時協作，根據反饋動態調整處理策略。
• 自動化創作：從創意構思到最終輸出，AI 智能體可以全流程自動化處理。
• 工具鏈整合：AI 智能體可以調用 VideoCutter 的所有 67 個專業工具，實現複雜任務。

5. 高效的批量處理功能

批量圖片疊加

• 命令文件支持：通過 TXT 文件定義批量疊加命令。
• 靈活命令格式：支持圖片疊加和文字疊加兩種命令格式。
• 參數化配置：支持位置、透明度、縮放、字體等參數自定義。
• 智能命令識別：自動識別圖片命令和文字命令，無需手動指定類型。
• 批量執行：一次性處理多個疊加操作，大幅提升效率。

批量文字疊加

• 多字體支持：支持系統字體和自定義字體文件。
• 豐富文字效果：支持陰影、描邊、發光等多種文字效果。
• 精確定位：支持 81 宮格精確定位系統，實現像素級精確控制。
• 參數化配置：支持字體大小、顏色、透明度等參數自定義。

批量處理優勢

• 高效處理：批量操作比單個操作效率提升數倍。
• 命令複用：命令文件可保存和重複使用。
• 錯誤處理：單個命令失敗不影響整體處理流程。
• 靈活配置：支持默認值和參數覆蓋，適應不同場景需求。

🔌 接口集成指南

1. REST API 接口

VideoCutter 提供完整的 REST API，支持 HTTP 請求直接調用各種處理功能。

服務信息

• API 服務地址：http://localhost:8900
• 交互式文檔：http://localhost:8900/docs
• ReDoc 文檔：http://localhost:8900/redoc
• 健康檢查：http://localhost:8900/health

接口特點

• 標準化設計：遵循 RESTful API 設計規範。
• 統一響應格式：所有接口返回統一的 JSON 格式。
• 文件上傳支持：支持 multipart/form - data 文件上傳。
• 參數驗證：完整的請求參數驗證和錯誤處理。
• AI 模型集成：內置 AI 模型 API，支持文本生成、圖像生成、視頻生成。

AI 模型 API

• 文本生成：支持 Ollama、豆包、硅基流動等文本生成模型。
• 圖像生成：支持文生圖功能，多種分辨率和藝術風格。
• 視頻生成：支持文生視頻和圖片轉視頻功能。
• 分段內容生成：AI 輔助生成視頻分段描述和字幕。

詳細文檔

完整的 API 接口文檔請參考：VideoCutter_API 使用文檔.md

2. MCP 協議接口

Model Context Protocol (MCP) 讓 AI 模型能夠直接調用 VideoCutter 的各種功能。支持兩種傳輸模式，滿足不同的應用場景需求。

服務信息

• SSE 服務器：http://localhost:8000/mcp/sse
• HTTP Streamable 服務器：http://localhost:8001/mcp/streamable

傳輸模式特點

SSE 模式 (Server - Sent Events)

• 特點：單向實時推送，服務器主動向客戶端發送數據。
• 優勢：低延遲、簡單易用、適合進度監控。
• 應用場景：長時間處理任務的實時反饋、狀態更新。
• 技術特點：基於 HTTP 長連接，自動重連機制。

HTTP Streamable 模式

• 特點：雙向流式通信，支持客戶端與服務器實時交互。
• 優勢：支持複雜交互、實時協作、動態調整。
• 應用場景：需要實時交互的複雜工作流、AI 智能體協作。
• 技術特點：基於 HTTP/2 流式傳輸，支持併發處理。

協議特點

• AI 友好：專為 AI 模型集成設計，支持自然語言調用。
• 流式響應：支持實時進度反饋和結果流式傳輸。
• 雙傳輸模式：支持 SSE 和 HTTP Streamable 兩種傳輸方式。
• 工具豐富：提供 67 個專業媒體處理工具。
• AI 工具集成：內置 AI 模型調用工具，支持文本、圖像、視頻生成。

AI 工具支持

• 文本生成工具：支持多種 AI 模型的文本生成功能。
• 圖像生成工具：支持文生圖和圖片處理功能。
• 視頻生成工具：支持文生視頻和圖片轉視頻功能。
• 智能處理工具：支持智能變速、場景檢測等 AI 輔助功能。

詳細文檔

完整的 MCP 工具文檔請參考：VideoCutter_MCP 使用文檔.md

📚 文檔資源

• API 使用文檔：VideoCutter_API 使用文檔.md - 詳細的 REST API 接口說明。
• MCP 使用文檔：VideoCutter_MCP 使用文檔.md - 完整的 MCP 工具使用指南。
• AI 模型使用說明：AI 模型使用說明.md - AI 功能配置和使用指南。
• 位置參數詳解：VideoCutter_Position 位置參數詳解.md - 81 宮格定位系統詳細說明。
• 用戶使用指南：本文檔 - 產品介紹和集成指南。

聯繫作者

提供一站式部署，安裝，激活服務

• github: https://github.com/daimaxiuligong/VideoCutter
• 碼雲: https://gitee.com/daimaxiuligong/VideoCutter