本地影片媒體 (MCP)
VidSeeds.ai 遵循用戶端優先的媒體處理原則:代管的 MCP 伺服器不會讀取用戶電腦上的檔案。工具會返回配方(ffmpeg/ffprobe 命令)或接受 agent 在本地提取的 base64 幀。
探測檔案
vidseeds_probe_local_video— 持續時間、解析度、編碼;請在裁切或選擇縮圖幀前使用。
幀與片段
| 目標 | 工具 |
|---|---|
| 靜態幀(用於縮圖) | vidseeds_extract_video_frames |
| 短片片段(用於情境) | vidseeds_extract_video_clip |
| 通用轉碼配方 | vidseeds_transcode_format_recipe |
| 媒體輔助命令 | vidseeds_get_local_media_recipe |
在用戶的機器上執行返回的 shell 命令(需已安裝 ffmpeg/ffprobe)。必要時,將結果以 frames 形式傳回 vidseeds_generate_thumbnail 縮圖工具。
精確裁切
vidseeds_analyze_precision_trim— 建議的剪輯點、片段目錄、種子成本預覽。vidseeds_plan_precision_trim— AI 編輯計畫(CritiquePlan),包含類型感知處理。vidseeds_execute_precision_trim— 匯出可在本地 ffmpeg 執行的配方/命令。
V3 類型感知處理 (2026-06-27)
精確裁切 V3 增加了類型分類 + 音景分析 + 動態輪廓 + 鉤子偵測 + 語義邊界作為平行的用戶端訊號。這些可作為可選中繼資料傳遞給 vidseeds_analyze_precision_trim 和 vidseeds_plan_precision_trim 的輸入:
detectedGenre— 覆蓋自動類型偵測(speech_driven、action_dynamic、ambient_relax、visual_primary、mixed_narrative、tutorial)soundscape— 來自 PCM 的頻譜分類(silence、speech、music、ambient、noise)motionProfile— 逐幀像素差異分析(static、slow、action、scene_change)
對計畫的影響:
- ambient_relax:高靜音容忍度(15 秒以上),保留無語言場景,裁切比例低於 20%
- action_dynamic:積極的暫停裁切(500 毫秒以上),裁切比例可達 40%
- speech_driven:在語義邊界處裁切,適度修剪
- visual_primary:保留無語言場景,僅在真正靜音時裁切
- mixed_narrative:使用所有訊號,僅在多項訊號一致時裁切
- tutorial:精確裁切,在指令周圍不進行加速
中段廣告放置
vidseeds_analyze_midroll_opportunities— 根據逐字稿/情境建議的中段廣告時間點(僅分析;用戶在其編輯器中自行編輯)。
來自本地檔案的縮圖
當整個流程應在磁碟上執行時,建議使用 vidseeds-local stdio MCP 工具 vidseeds_generate_thumbnail_from_video(請參閱 vidseeds-thumbnails)。
YouTube 代管的來源(非本地路徑)
vidseeds_get_youtube_video_transcript、vidseeds_get_youtube_video_captions— 從 YouTube 取得文字內容,無需將影片下載至伺服器。
不要做的事
- 不要期望代管工具接受任意的檔案系統路徑來進行上傳/處理。
- 不要在迴圈中重複執行探測/提取動作 — 請將會話期間的探測結果快取起來。