做混剪最花時間的不是拍攝而是從一堆素材里找鏡頭、定順序、卡節(jié)奏、配 BGM。過去這套流程要在剪輯軟件里手動完成今天借助 Grok 這類大模型和 FFmpeg可以把它壓縮成手機上一句話的事。最近 Grok 剪輯 Bot 的開源項目讓不少人開始嘗試自建“一句話混剪”服務(wù)本文就以這類項目的通用架構(gòu)為藍(lán)本從原理、代碼到踩坑完整拆解一個最小可用的混剪 Bot 是怎么跑起來的。如果你正在做自媒體切片、游戲高光集錦或者單純想體驗“AI 直接出片”的完整鏈路這篇文章都適用。即使你之前沒寫過 Bot也沒碰過 FFmpeg按著下面的步驟走也能搭出一個能跑的原型。1. 背景為什么“一句話混剪”值得關(guān)注1.1 從“手動剪片”到“對話式剪輯”先解釋一下混剪這件事?；旒艟褪前讯鄠€視頻片段按照主題重新排列組合配上合適的轉(zhuǎn)場、背景音樂和字幕最終形成一條新的短視頻。它常用于影視解說、產(chǎn)品宣傳、個人 vlog 集錦、游戲高光時刻等場景也是短視頻平臺上非常主流的內(nèi)容形式。傳統(tǒng)流程是先收集素材再在剪輯軟件里導(dǎo)入然后手動拖動時間線調(diào)整每個片段的出入點添加轉(zhuǎn)場和字幕最后配上背景音樂再導(dǎo)出。這個流程對新手來說學(xué)習(xí)成本不低即便對熟練的剪輯師一次成型也需要反復(fù)預(yù)覽和調(diào)整。對話式剪輯的核心變化在于把“挑選素材、決定順序、安排轉(zhuǎn)場”這些需要經(jīng)驗和判斷力的工作交給大模型把“執(zhí)行剪輯命令”交給腳本和 FFmpeg。用戶只需要告訴機器人“我想要一條 30 秒的旅行混剪節(jié)奏快一點結(jié)尾留一個夕陽鏡頭”剩下的事情由系統(tǒng)自動完成。這種方式不是要取代專業(yè)剪輯軟件而是把高頻、重復(fù)、低難度的混剪需求自動化。對個人創(chuàng)作者和中小團(tuán)隊來說效率提升非常明顯。1.2 Grok 剪輯 Bot 是什么Grok 是 xAI 推出的大語言模型擅長理解自然語言也可以按要求輸出結(jié)構(gòu)化 JSON。所謂 Grok 剪輯 Bot就是基于 Grok 的對話與結(jié)構(gòu)化輸出能力配合 FFmpeg 等視頻處理工具實現(xiàn)“一句話生成混剪成片”的自動化機器人。這個項目思路的價值在于把 AI 從“聊天助手”變成“創(chuàng)作執(zhí)行器”。Grok 不只是回復(fù)文字而是輸出一套可執(zhí)行的剪輯計劃。把視頻剪輯門檻降到一句話。用戶不需要安裝復(fù)雜軟件也不需要懂轉(zhuǎn)場術(shù)語。開源之后社區(qū)可以自行部署、二次開發(fā)比如接入自己的素材庫、改成直播切片工具、增加字幕翻譯等。所以它本質(zhì)上是一個“大模型 命令行視頻工具”組合出來的自動化流水線核心并不神秘關(guān)鍵在提示詞設(shè)計和數(shù)據(jù)契約。1.3 開源的意義與應(yīng)用場景開源帶來的直接好處是透明和可擴展。你可以看到模型提示詞怎么寫、視頻命令怎么拼也可以按自己的需求改比如把 Grok 換成其他兼容接口的模型或者把輸出端從 FFmpeg 換成 OBS 推流。這類 Bot 的典型應(yīng)用場景包括自媒體素材剪輯批量把節(jié)目片段生成標(biāo)題片段。游戲高光時刻自動把擊殺鏡頭剪輯成集錦。企業(yè)內(nèi)部培訓(xùn)快速生成課程花絮。個人視頻日志睡前發(fā)一句話第二天收到一條成片。2. 整體架構(gòu)與核心概念2.1 一句話生成混剪的完整鏈路從用戶在手機發(fā)一句話到最終收到成片中間大概經(jīng)歷下面幾個環(huán)節(jié)手機 / IM 發(fā)送一句話 ↓ Bot 服務(wù)接收消息 ↓ Grok API 生成剪輯計劃JSON ↓ 校驗剪輯計劃 ↓ FFmpeg 執(zhí)行裁剪、拼接、混音 ↓ 生成成片結(jié)果回傳這里有兩個關(guān)鍵設(shè)計。一是把“意圖理解”和“視頻執(zhí)行”分開。Grok 只負(fù)責(zé)生成剪輯計劃不直接操控視頻文件FFmpeg 只負(fù)責(zé)執(zhí)行不關(guān)心用戶意圖。這樣每個環(huán)節(jié)都可以獨立測試和獨立替換。二是把“素材選擇”收斂到有限集合。為了讓 Grok 能指定素材系統(tǒng)需要提前維護(hù)一個素材清單并把素材文件名、時長、畫面內(nèi)容概要告訴模型。模型只能從中挑選不能憑空編造文件名。2.2 三個核心模塊整個系統(tǒng)可以拆成三個部分Bot 接入層負(fù)責(zé)接收手機端消息返回任務(wù)進(jìn)度和成片。最小實現(xiàn)是一個 HTTP 服務(wù)手機或聊天軟件通過 Webhook 調(diào)用。計劃生成層調(diào)用 Grok API把用戶的一句話變成結(jié)構(gòu)化的剪輯計劃。核心是提示詞設(shè)計和 JSON 解析校驗。視頻執(zhí)行層讀取剪輯計劃調(diào)用 FFmpeg 完成片段裁剪、順序拼接、BGM 混音最終輸出 MP4。三層職責(zé)清晰之后后面寫代碼會非常順利。2.3 技術(shù)選型為什么用 Grok FFmpeg選 Grok 而不是自己寫規(guī)則引擎是因為自然語言需求變化太多?！翱煲稽c”“悲傷一點”“最后要一個夕陽鏡頭”這類描述規(guī)則很難覆蓋但大模型能理解。選 FFmpeg 而不是 Premiere 或剪映的自動化接口是因為 FFmpeg 是命令行工具跨平臺、免費、可腳本化特別適合服務(wù)端批處理。整體技術(shù)棧如下Python 3.10Grok API接口兼容 OpenAI 風(fēng)格可使用 openai 庫調(diào)用FFmpegFlask 或 FastAPI作為 Bot 入口簡單文件目錄做素材庫3. 環(huán)境準(zhǔn)備與項目初始化3.1 運行環(huán)境操作系統(tǒng)Windows / macOS / Linux 均可本文以 Linux 服務(wù)端為例。手機端不用安裝任何軟件只負(fù)責(zé)發(fā)消息和接收成片。Python建議 3.10 及以上。FFmpeg需要安裝到系統(tǒng) PATH 中。安裝 FFmpegLinux 上可以用系統(tǒng)包管理器# Debian / Ubuntu sudo apt update sudo apt install ffmpeg # macOS brew install ffmpeg安裝完成后驗證一下ffmpeg -version能正常打印版本號說明安裝成功。3.2 獲取 Grok API Key調(diào)用 Grok 需要一個 API Key。到 xAI 開放平臺申請后把 Key 放到.env文件里注意不要提交到 Git 倉庫XAI_API_KEY你的_key XAI_BASE_URLhttps://api.x.ai/v1 XAI_MODELgrok-3需要特別說明模型名和 Base URL 會隨官方版本迭代變化實際使用以 xAI 官方文檔為準(zhǔn)。示例中使用環(huán)境變量傳參就是為了方便你替換。3.3 項目依賴與目錄結(jié)構(gòu)新建項目目錄例如grok-clip-bot然后準(zhǔn)備依賴文件# requirements.txt openai1.0.0 flask2.0.0 python-dotenv1.0.0 requests2.28.0安裝依賴pip install -r requirements.txt推薦的項目目錄結(jié)構(gòu)grok-clip-bot/ ├── .env ├── requirements.txt ├── app.py # Bot 服務(wù)入口 ├── grok_client.py # Grok API 調(diào)用與剪輯計劃解析 ├── video_engine.py # FFmpeg 視頻執(zhí)行引擎 └── materials/ # 素材目錄 ├── material_01.mp4 ├── material_02.mp4 ├── material_03.mp4 └── bgm_01.mp3其中materials目錄放預(yù)設(shè)素材Grok 只能選擇這些素材文件不能執(zhí)行任意文件操作。這樣設(shè)計有兩個好處模型輸出更穩(wěn)定且不會因為用戶輸入非法路徑導(dǎo)致安全問題。4. 核心實現(xiàn)Grok 如何把一句話變成剪輯計劃4.1 Grok API 的基礎(chǔ)調(diào)用Grok 的接口兼容 OpenAI 風(fēng)格所以可以直接使用openai庫。先寫一個最基礎(chǔ)的客戶端# 文件路徑grok_client.py import os import json from openai import OpenAI client OpenAI( api_keyos.environ.get(XAI_API_KEY), base_urlos.environ.get(XAI_BASE_URL, https://api.x.ai/v1), ) MODEL os.environ.get(XAI_MODEL, grok-3) def chat(text: str) - str: resp client.chat.completions.create( modelMODEL, messages[{role: user, content: text}], temperature0.7, ) return resp.choices[0].message.content這段代碼的作用是傳入一段文本返回 Grok 生成的回復(fù)。注意這里只是最基礎(chǔ)的調(diào)用實際剪輯場景還需要更嚴(yán)格的提示詞和輸出約束。4.2 讓 Grok 輸出結(jié)構(gòu)化剪輯計劃大模型直接輸出的自然語言很難驅(qū)動 FFmpeg所以要讓 Grok 按固定 JSON 格式返回剪輯計劃。這里提示詞是關(guān)鍵。設(shè)計系統(tǒng)提示詞時需要告訴模型三件事身份、輸入約束、輸出格式。# 文件路徑grok_client.py補充 PLAN_SYSTEM_PROMPT 你是一個短視頻混剪導(dǎo)演。用戶會輸入一句話需求你需要根據(jù)素材清單生成一份剪輯計劃。 只輸出 JSON不要輸出任何解釋文字。JSON 格式如下 { theme: 視頻主題, subtitle: 全程顯示的字幕文本, clips: [ {source: 素材文件名, start: 0, duration: 3} ], bgm: 背景音樂文件名, bgm_volume: 0.3, transition: cut } 素材清單如下 {material_list} 規(guī)則 1. clips 至少包含 2 個片段每個片段 2 到 5 秒。 2. source 必須從素材清單中選擇不能編造文件名。 3. start 表示從素材的哪個秒數(shù)開始截取不能超過素材時長。 4. duration 是截取時長單位秒。 5. transition 只能取值 cut 或 fade。 素材清單可以這樣動態(tài)生成# 文件路徑grok_client.py補充 def build_material_list(material_dir: str materials) - str: items [] for f in os.listdir(material_dir): if f.endswith(.mp4) or f.endswith(.mp3): items.append(f) return \n.join(items)然后調(diào)用帶系統(tǒng)提示詞的接口# 文件路徑grok_client.py補充 def generate_plan(user_text: str, material_dir: str materials) - dict: material_list build_material_list(material_dir) resp client.chat.completions.create( modelMODEL, messages[ { role: system, content: PLAN_SYSTEM_PROMPT.format(material_listmaterial_list), }, {role: user, content: user_text}, ], temperature0.3, response_format{type: json_object}, ) content resp.choices[0].message.content try: return json.loads(content) except json.JSONDecodeError as e: raise ValueError(fGrok 返回內(nèi)容不是合法 JSON: {content}) from e這里把temperature調(diào)低到 0.3是為了讓模型更穩(wěn)定地按 JSON 輸出減少隨機表達(dá)。response_format如果當(dāng)前模型不支持可以去掉這一項但要在提示詞里反復(fù)強調(diào)“只輸出 JSON”。4.3 解析與校驗返回結(jié)果大模型輸出再穩(wěn)定也可能出現(xiàn)字段缺失、素材名寫錯、時長超過素材長度等問題。所以拿到 JSON 后必須校驗不能直接拿去執(zhí)行。# 文件路徑grok_client.py補充 def validate_plan(plan: dict) - dict: clips plan.get(clips) if not isinstance(clips, list) or len(clips) 0: raise ValueError(剪輯計劃中缺少 clips 字段) for i, clip in enumerate(clips): source clip.get(source) if not source or not isinstance(source, str): raise ValueError(f第 {i 1} 個片段缺少 source) if not isinstance(clip.get(start, 0), (int, float)): clip[start] 0 if not isinstance(clip.get(duration, 3), (int, float)): clip[duration] 3 # 限制單片段最長 15 秒防止生成異常長片段 clip[duration] min(float(clip[duration]), 15.0) if not plan.get(bgm): plan[bgm] None return plan校驗的主要目的是讓下游 FFmpeg 引擎拿到的一定是結(jié)構(gòu)正確的數(shù)據(jù)避免因為一個字段異常導(dǎo)致整條視頻生成失敗。5. 視頻引擎把剪輯計劃變成成片5.1 素材管理規(guī)則FFmpeg 執(zhí)行前先確定素材都放在materials目錄。為了讓 Grok 正確引用素材文件名不要帶空格和特殊字符推薦用material_01.mp4這樣的規(guī)范命名。如果素材較多可以在materials下生成一個manifest.json描述每個素材的畫面內(nèi)容、時長、風(fēng)格再把這部分信息拼進(jìn)提示詞。這樣模型可以更好地理解素材內(nèi)容而不是只看文件名。5.2 用 FFmpeg 實現(xiàn)裁剪 大模型+FFmpeg：從零搭建一句話混剪機器人
做混剪最花時間的不是拍攝而是從一堆素材里找鏡頭、定順序、卡節(jié)奏、配 BGM。過去這套流程要在剪輯軟件里手動完成今天借助 Grok 這類大模型和 FFmpeg可以把它壓縮成手機上一句話的事。最近 Grok 剪輯 Bot 的開源項目讓不少人開始嘗試自建“一句話混剪”服務(wù)本文就以這類項目的通用架構(gòu)為藍(lán)本從原理、代碼到踩坑完整拆解一個最小可用的混剪 Bot 是怎么跑起來的。如果你正在做自媒體切片、游戲高光集錦或者單純想體驗“AI 直接出片”的完整鏈路這篇文章都適用。即使你之前沒寫過 Bot也沒碰過 FFmpeg按著下面的步驟走也能搭出一個能跑的原型。1. 背景為什么“一句話混剪”值得關(guān)注1.1 從“手動剪片”到“對話式剪輯”先解釋一下混剪這件事?；旒艟褪前讯鄠€視頻片段按照主題重新排列組合配上合適的轉(zhuǎn)場、背景音樂和字幕最終形成一條新的短視頻。它常用于影視解說、產(chǎn)品宣傳、個人 vlog 集錦、游戲高光時刻等場景也是短視頻平臺上非常主流的內(nèi)容形式。傳統(tǒng)流程是先收集素材再在剪輯軟件里導(dǎo)入然后手動拖動時間線調(diào)整每個片段的出入點添加轉(zhuǎn)場和字幕最后配上背景音樂再導(dǎo)出。這個流程對新手來說學(xué)習(xí)成本不低即便對熟練的剪輯師一次成型也需要反復(fù)預(yù)覽和調(diào)整。對話式剪輯的核心變化在于把“挑選素材、決定順序、安排轉(zhuǎn)場”這些需要經(jīng)驗和判斷力的工作交給大模型把“執(zhí)行剪輯命令”交給腳本和 FFmpeg。用戶只需要告訴機器人“我想要一條 30 秒的旅行混剪節(jié)奏快一點結(jié)尾留一個夕陽鏡頭”剩下的事情由系統(tǒng)自動完成。這種方式不是要取代專業(yè)剪輯軟件而是把高頻、重復(fù)、低難度的混剪需求自動化。對個人創(chuàng)作者和中小團(tuán)隊來說效率提升非常明顯。1.2 Grok 剪輯 Bot 是什么Grok 是 xAI 推出的大語言模型擅長理解自然語言也可以按要求輸出結(jié)構(gòu)化 JSON。所謂 Grok 剪輯 Bot就是基于 Grok 的對話與結(jié)構(gòu)化輸出能力配合 FFmpeg 等視頻處理工具實現(xiàn)“一句話生成混剪成片”的自動化機器人。這個項目思路的價值在于把 AI 從“聊天助手”變成“創(chuàng)作執(zhí)行器”。Grok 不只是回復(fù)文字而是輸出一套可執(zhí)行的剪輯計劃。把視頻剪輯門檻降到一句話。用戶不需要安裝復(fù)雜軟件也不需要懂轉(zhuǎn)場術(shù)語。開源之后社區(qū)可以自行部署、二次開發(fā)比如接入自己的素材庫、改成直播切片工具、增加字幕翻譯等。所以它本質(zhì)上是一個“大模型 命令行視頻工具”組合出來的自動化流水線核心并不神秘關(guān)鍵在提示詞設(shè)計和數(shù)據(jù)契約。1.3 開源的意義與應(yīng)用場景開源帶來的直接好處是透明和可擴展。你可以看到模型提示詞怎么寫、視頻命令怎么拼也可以按自己的需求改比如把 Grok 換成其他兼容接口的模型或者把輸出端從 FFmpeg 換成 OBS 推流。這類 Bot 的典型應(yīng)用場景包括自媒體素材剪輯批量把節(jié)目片段生成標(biāo)題片段。游戲高光時刻自動把擊殺鏡頭剪輯成集錦。企業(yè)內(nèi)部培訓(xùn)快速生成課程花絮。個人視頻日志睡前發(fā)一句話第二天收到一條成片。2. 整體架構(gòu)與核心概念2.1 一句話生成混剪的完整鏈路從用戶在手機發(fā)一句話到最終收到成片中間大概經(jīng)歷下面幾個環(huán)節(jié)手機 / IM 發(fā)送一句話 ↓ Bot 服務(wù)接收消息 ↓ Grok API 生成剪輯計劃JSON ↓ 校驗剪輯計劃 ↓ FFmpeg 執(zhí)行裁剪、拼接、混音 ↓ 生成成片結(jié)果回傳這里有兩個關(guān)鍵設(shè)計。一是把“意圖理解”和“視頻執(zhí)行”分開。Grok 只負(fù)責(zé)生成剪輯計劃不直接操控視頻文件FFmpeg 只負(fù)責(zé)執(zhí)行不關(guān)心用戶意圖。這樣每個環(huán)節(jié)都可以獨立測試和獨立替換。二是把“素材選擇”收斂到有限集合。為了讓 Grok 能指定素材系統(tǒng)需要提前維護(hù)一個素材清單并把素材文件名、時長、畫面內(nèi)容概要告訴模型。模型只能從中挑選不能憑空編造文件名。2.2 三個核心模塊整個系統(tǒng)可以拆成三個部分Bot 接入層負(fù)責(zé)接收手機端消息返回任務(wù)進(jìn)度和成片。最小實現(xiàn)是一個 HTTP 服務(wù)手機或聊天軟件通過 Webhook 調(diào)用。計劃生成層調(diào)用 Grok API把用戶的一句話變成結(jié)構(gòu)化的剪輯計劃。核心是提示詞設(shè)計和 JSON 解析校驗。視頻執(zhí)行層讀取剪輯計劃調(diào)用 FFmpeg 完成片段裁剪、順序拼接、BGM 混音最終輸出 MP4。三層職責(zé)清晰之后后面寫代碼會非常順利。2.3 技術(shù)選型為什么用 Grok FFmpeg選 Grok 而不是自己寫規(guī)則引擎是因為自然語言需求變化太多?！翱煲稽c”“悲傷一點”“最后要一個夕陽鏡頭”這類描述規(guī)則很難覆蓋但大模型能理解。選 FFmpeg 而不是 Premiere 或剪映的自動化接口是因為 FFmpeg 是命令行工具跨平臺、免費、可腳本化特別適合服務(wù)端批處理。整體技術(shù)棧如下Python 3.10Grok API接口兼容 OpenAI 風(fēng)格可使用 openai 庫調(diào)用FFmpegFlask 或 FastAPI作為 Bot 入口簡單文件目錄做素材庫3. 環(huán)境準(zhǔn)備與項目初始化3.1 運行環(huán)境操作系統(tǒng)Windows / macOS / Linux 均可本文以 Linux 服務(wù)端為例。手機端不用安裝任何軟件只負(fù)責(zé)發(fā)消息和接收成片。Python建議 3.10 及以上。FFmpeg需要安裝到系統(tǒng) PATH 中。安裝 FFmpegLinux 上可以用系統(tǒng)包管理器# Debian / Ubuntu sudo apt update sudo apt install ffmpeg # macOS brew install ffmpeg安裝完成后驗證一下ffmpeg -version能正常打印版本號說明安裝成功。3.2 獲取 Grok API Key調(diào)用 Grok 需要一個 API Key。到 xAI 開放平臺申請后把 Key 放到.env文件里注意不要提交到 Git 倉庫XAI_API_KEY你的_key XAI_BASE_URLhttps://api.x.ai/v1 XAI_MODELgrok-3需要特別說明模型名和 Base URL 會隨官方版本迭代變化實際使用以 xAI 官方文檔為準(zhǔn)。示例中使用環(huán)境變量傳參就是為了方便你替換。3.3 項目依賴與目錄結(jié)構(gòu)新建項目目錄例如grok-clip-bot然后準(zhǔn)備依賴文件# requirements.txt openai1.0.0 flask2.0.0 python-dotenv1.0.0 requests2.28.0安裝依賴pip install -r requirements.txt推薦的項目目錄結(jié)構(gòu)grok-clip-bot/ ├── .env ├── requirements.txt ├── app.py # Bot 服務(wù)入口 ├── grok_client.py # Grok API 調(diào)用與剪輯計劃解析 ├── video_engine.py # FFmpeg 視頻執(zhí)行引擎 └── materials/ # 素材目錄 ├── material_01.mp4 ├── material_02.mp4 ├── material_03.mp4 └── bgm_01.mp3其中materials目錄放預(yù)設(shè)素材Grok 只能選擇這些素材文件不能執(zhí)行任意文件操作。這樣設(shè)計有兩個好處模型輸出更穩(wěn)定且不會因為用戶輸入非法路徑導(dǎo)致安全問題。4. 核心實現(xiàn)Grok 如何把一句話變成剪輯計劃4.1 Grok API 的基礎(chǔ)調(diào)用Grok 的接口兼容 OpenAI 風(fēng)格所以可以直接使用openai庫。先寫一個最基礎(chǔ)的客戶端# 文件路徑grok_client.py import os import json from openai import OpenAI client OpenAI( api_keyos.environ.get(XAI_API_KEY), base_urlos.environ.get(XAI_BASE_URL, https://api.x.ai/v1), ) MODEL os.environ.get(XAI_MODEL, grok-3) def chat(text: str) - str: resp client.chat.completions.create( modelMODEL, messages[{role: user, content: text}], temperature0.7, ) return resp.choices[0].message.content這段代碼的作用是傳入一段文本返回 Grok 生成的回復(fù)。注意這里只是最基礎(chǔ)的調(diào)用實際剪輯場景還需要更嚴(yán)格的提示詞和輸出約束。4.2 讓 Grok 輸出結(jié)構(gòu)化剪輯計劃大模型直接輸出的自然語言很難驅(qū)動 FFmpeg所以要讓 Grok 按固定 JSON 格式返回剪輯計劃。這里提示詞是關(guān)鍵。設(shè)計系統(tǒng)提示詞時需要告訴模型三件事身份、輸入約束、輸出格式。# 文件路徑grok_client.py補充 PLAN_SYSTEM_PROMPT 你是一個短視頻混剪導(dǎo)演。用戶會輸入一句話需求你需要根據(jù)素材清單生成一份剪輯計劃。 只輸出 JSON不要輸出任何解釋文字。JSON 格式如下 { theme: 視頻主題, subtitle: 全程顯示的字幕文本, clips: [ {source: 素材文件名, start: 0, duration: 3} ], bgm: 背景音樂文件名, bgm_volume: 0.3, transition: cut } 素材清單如下 {material_list} 規(guī)則 1. clips 至少包含 2 個片段每個片段 2 到 5 秒。 2. source 必須從素材清單中選擇不能編造文件名。 3. start 表示從素材的哪個秒數(shù)開始截取不能超過素材時長。 4. duration 是截取時長單位秒。 5. transition 只能取值 cut 或 fade。 素材清單可以這樣動態(tài)生成# 文件路徑grok_client.py補充 def build_material_list(material_dir: str materials) - str: items [] for f in os.listdir(material_dir): if f.endswith(.mp4) or f.endswith(.mp3): items.append(f) return \n.join(items)然后調(diào)用帶系統(tǒng)提示詞的接口# 文件路徑grok_client.py補充 def generate_plan(user_text: str, material_dir: str materials) - dict: material_list build_material_list(material_dir) resp client.chat.completions.create( modelMODEL, messages[ { role: system, content: PLAN_SYSTEM_PROMPT.format(material_listmaterial_list), }, {role: user, content: user_text}, ], temperature0.3, response_format{type: json_object}, ) content resp.choices[0].message.content try: return json.loads(content) except json.JSONDecodeError as e: raise ValueError(fGrok 返回內(nèi)容不是合法 JSON: {content}) from e這里把temperature調(diào)低到 0.3是為了讓模型更穩(wěn)定地按 JSON 輸出減少隨機表達(dá)。response_format如果當(dāng)前模型不支持可以去掉這一項但要在提示詞里反復(fù)強調(diào)“只輸出 JSON”。4.3 解析與校驗返回結(jié)果大模型輸出再穩(wěn)定也可能出現(xiàn)字段缺失、素材名寫錯、時長超過素材長度等問題。所以拿到 JSON 后必須校驗不能直接拿去執(zhí)行。# 文件路徑grok_client.py補充 def validate_plan(plan: dict) - dict: clips plan.get(clips) if not isinstance(clips, list) or len(clips) 0: raise ValueError(剪輯計劃中缺少 clips 字段) for i, clip in enumerate(clips): source clip.get(source) if not source or not isinstance(source, str): raise ValueError(f第 {i 1} 個片段缺少 source) if not isinstance(clip.get(start, 0), (int, float)): clip[start] 0 if not isinstance(clip.get(duration, 3), (int, float)): clip[duration] 3 # 限制單片段最長 15 秒防止生成異常長片段 clip[duration] min(float(clip[duration]), 15.0) if not plan.get(bgm): plan[bgm] None return plan校驗的主要目的是讓下游 FFmpeg 引擎拿到的一定是結(jié)構(gòu)正確的數(shù)據(jù)避免因為一個字段異常導(dǎo)致整條視頻生成失敗。5. 視頻引擎把剪輯計劃變成成片5.1 素材管理規(guī)則FFmpeg 執(zhí)行前先確定素材都放在materials目錄。為了讓 Grok 正確引用素材文件名不要帶空格和特殊字符推薦用material_01.mp4這樣的規(guī)范命名。如果素材較多可以在materials下生成一個manifest.json描述每個素材的畫面內(nèi)容、時長、風(fēng)格再把這部分信息拼進(jìn)提示詞。這樣模型可以更好地理解素材內(nèi)容而不是只看文件名。5.2 用 FFmpeg 實現(xiàn)裁剪