OpenClip:將長片內容批量改編為短片格式
這是端到端的工作流程技能。輸入一部長片,輸出一組可直接發布的直式短片,每支短片都有字幕與文案。它整合了 OpenClip 的剪輯流水線、字幕以及免費的媒體工具。
剪輯流水線是付費的(需要有效的訂閱與點數)。重新構圖與修剪工具則是免費的。
設定(一次性)
OpenClip 是一個遠端 MCP 伺服器,位址為 https://openclip.app/mcp。在 OAuth 提示出現時使用你的 OpenClip 帳號登入,無需複製 API 金鑰。
- Claude Code:
claude mcp add --transport http openclip https://openclip.app/mcp,然後執行/mcp進行授權。 - Claude Desktop / web: 設定 > 連接器 >「新增自訂連接器」,貼上 URL,然後登入。
- Cursor(
.cursor/mcp.json):{ "mcpServers": { "openclip": { "url": "https://openclip.app/mcp" } } } - 僅限標頭的用戶端: 在
openclip.app/settings/connect建立一個 MCP 令牌,並使用Authorization: Bearer <令牌>連接到https://openclip.app/mcp/key。
完整性檢查:呼叫 get_account 並確認 credits_remaining > 0。
工作流程
開始之前,先與使用者商定兩件事:他們想要多少支短片,以及目標平台。這兩個答案將主導後續的每一個決策。請勿擅自替他們決定。
- 提交來源影片。 使用
submit_video(url)。回傳一個job_id,狀態為queued。 若是本機檔案:使用create_upload,PUT 放入位元組,然後complete_upload。 - 輪詢直到完成。 呼叫
get_video_status(job_id)直到狀態變為completed。若近乎立刻顯示failed,表示沒有有效的訂閱。若顯示pending_credits,表示點數不足。請直接告知使用者並停止,不要再持續輪詢終端狀態。 - 提取精彩時刻。 使用
list_clips(job_id)。依照virality_score(0 到 10)排序,並選取使用者要求的數量。在渲染任何內容之前,先向使用者顯示包含標題、鉤子、時長與分數的精選清單,讓他們可以否決。渲染會消耗點數。 - 為每個選中的時刻加上字幕。 使用
list_caption_presets,然後對每個獲批准的時刻呼叫render_clip(moment_id, caption_preset)。輪詢list_clips,直到每個時刻都有rendered_clip。 - 如有需要則重新構圖。 流水線的輸出已經是短格式導向。如果使用者需要特定平台的不同比例,請對已渲染的剪輯執行免費的
edit_video(video, operation="crop", aspect="9:16" | "1:1" | "4:5")。 - 交付整批短片。 對每支短片提供:
rendered_clipURL、title、hook、social_copy、duration_ms、virality_score,以及建議的platforms欄位。
平台比例
- TikTok、Reels、Shorts - 9:16 直式。這是預設值,流水線以此為目標。
- Instagram 動態牆 - 4:5 或 1:1。使用
edit_video裁剪已渲染的剪輯。 - X 與 LinkedIn - 16:9 或 1:1 都行。字幕比比例更重要,這些平台大多在靜音狀態下自動播放。
每個時刻都附帶來自流水線的 platforms 欄位。將其視為起始建議而非規則,並與使用者實際發布的平台進行比對。
流程順序與成本
- 批次輪詢。一次提交,然後在迴圈中輪詢
get_video_status,而不是重新提交。 - 僅渲染獲批准的時刻。每次
render_clip都會消耗資源,不要在使用者只要三支的情況下渲染全部十支。 - 對於重複性工作流程(相同的字幕、相同的構圖、每次相同的標誌浮水印),請使用
create_agent儲存一個處理代理,並將其傳遞給submit_video。這樣未來的每個批次都無需重新指定,而能保持一致。describe_agent_settings會列出所有欄位。 get_usage會顯示點數餘額(點數代表處理時間的分鐘數),請在使用者要求大量剪輯之前檢查。
規則
- 務必輪詢,每個步驟都是非同步的。
- 依照
virality_score排序,分數越高越好。使用viral_score_details解釋排名(鉤子強度、分享性、重看性、驚喜感、情感衝擊)。 - 時間單位為毫秒。
- 剪輯 URL 是永久的 CDN 連結,不會簽署或過期。
- 不支援專案與資料夾。 不要向使用者承諾資料夾結構。
- 除非被要求,否則不要將
social_copy改寫成網紅口吻。它是為了配合剪輯而產生的,過度改寫通常會使其變得更糟。
提示與動作範例
- 「把這個 podcast 變成 10 支 TikTok」 - 提交、輪詢、
list_clips、顯示前 10 名的精選清單、取得批准、為每支加上字幕渲染、輪詢、交付整批。 - 「給我這個網路研討會一週的內容」 - 同上,數量調整為 5 到 7 支,並使用每個時刻的
category按主題分組。 - 「只要最好那支,字幕要像 MrBeast 風格」 - 提交、輪詢、取出
virality_score最高的時刻、render_clip(moment_id, caption_preset="beast")、輪詢。 - 「跟上次一樣的風格」 - 在
submit_video重複使用已儲存的代理 ID。
相關資源
流水線機制與狀態處理的詳細資訊在 openclip-clipping。字幕預設與自訂字幕樣式在 openclip-captions。免費的裁剪、修剪與壓縮工具在 openclip-video-editing。