~/教學/SHORTS.md

文章 / AI 工具

SupoClip:開源的 OpusClip 替代品,一支長片丟進去,吐出打過分、能直接發的直式短片。Docker 自己架,GitHub 3,600 星

AI 從逐字稿挑 3-7 段最會爆的片段,每段打 hook / engagement / value / shareability 四個分數,自動轉 9:16、臉部置中、逐字字幕。要 Docker、AssemblyAI 金鑰和一把 LLM 金鑰;授權只限非商業。

一支一小時的 Podcast 或直播 VOD,想剪成幾支能發的 Reels / Shorts,OpusClip 這類工具很方便,但 Pro 方案定價一個月 29 美金,而且影片和流程都在他們的伺服器上。這篇是 Reels 裡 SHORTS 那支的完整版:SupoClip 是 GitHub 上 3,627 星(2026-11-20)的開源專案,README 自己寫「An open-source OpusClip alternative」,同一套流程(AI 挑片、打分、直式裁切、逐字字幕)可以用 Docker 架在自己的電腦上,非商業用途免費。需要什麼、怎麼裝、授權的限制,都在 2026-11-20 對照官方 README、LICENSE 和 .env.example 確認過。

01你會得到什麼:一支長片進去,3-7 支打過分的直式短片出來

opus.pro 定價頁:Starter $15 USD、Pro $29 USD,截圖當天兩個價格都被劃掉顯示促銷價 $12 和 $11.5 USD/mo
OpusClip 官方定價頁(2026-11-20 截圖):Pro 定價 $29 USD/月,當天頁面顯示年繳促銷價。

OpusClip 做的事很單純:你給它一支長片,它用 AI 找出最有機會爆的片段,裁成直式、上字幕、打一個 virality 分數。好用,但用量看方案計算,Pro 方案定價一個月 29 美金(opus.pro/pricing 2026-11-20 的月繳價;當天頁面另外顯示年繳促銷價),影片和成品都放在他們那邊。

SupoClip 是同一條流水線的開源版本:貼一個 YouTube 連結、Twitch 或 Kick 的 VOD,或是上傳自己的檔案,它會先用 AssemblyAI 做逐字稿,再讓你選的 LLM(Gemini、GPT、Claude 或本機的 Ollama 模型)從逐字稿裡挑出 3-7 段最值得剪的片段,然後每一段:

  1. 打四個分數:hook(開頭抓不抓人)、engagement(留不留得住)、value(有沒有料)、shareability(會不會被分享)。README 叫它 virality scoring。
  2. 自動裁成 9:16 直式,用臉部偵測讓講者一直在畫面中間(README:Smart vertical cropping)。
  3. 逐字字幕:用 AssemblyAI 的逐字時間戳,一個字一個字跳出來,可以換字體和字幕樣式。
  4. Hook title:AI 寫一句標題,燒在片頭前幾秒的畫面上方。
  5. 可選的 B-roll(Pexels 素材)和轉場,內建剪輯器可以修剪、分割、合併,匯出有 TikTok / Reels / Shorts 的預設尺寸。
GitHub 上 FujiwaraChoki/supoclip 的專案頁:About 寫 An open-source OpusClip alternative,Star 3.6k,Fork 824
官方 GitHub 專案頁(2026-11-20 截圖):3.6k 星、824 個 fork、831 次 commit,最新一筆是 1 小時前。
SupoClip 的操作畫面:左邊是 New generation、Create、Library 選單,中間一個輸入框寫 Paste a YouTube link, or drop a video file
官方 README 的產品圖(上半部):貼 YouTube 連結或拖一個影片檔進去,下面可以選 Auto 9:16、Captions。

先說清楚:這篇和 Reels 裡的畫面都是官方 README、官方 demo 頁和 LICENSE 的真實截圖,Reels 裡那條一小時的影片條是示意圖。我們沒有在自己的機器上跑過 SupoClip,下面的步驟以 2026-11-20 的 README 為準。另外,它免費的前提是「非商業自架」,公司用、接案用、拿去剪有營利的頻道都要先寫信拿許可,細節在最後一段。

02第 1 步:先準備三樣東西(Docker、AssemblyAI 金鑰、一把 LLM 金鑰)

README 的 Quick Start 只要求三樣:Docker、一把 AssemblyAI 的 API 金鑰(做逐字稿),和一把 LLM 的金鑰(挑片、打分、寫標題)。LLM 四選一:Google、OpenAI、Anthropic,或本機的 Ollama(Ollama 不用金鑰)。

  1. Docker:Mac / Windows 裝 Docker Desktop,開著它。官方自架教學寫的是 Docker 加 Compose v2 和 Git。
  2. AssemblyAI 金鑰:到 assemblyai.com 註冊,後台拿 API key。官方定價頁(2026-11-20)寫新帳號有 $50 美金的免費額度、不用綁信用卡;用完之後按音訊時數計費,價格看他們的 rate card。
  3. LLM 金鑰:README 範例用 Google 的 Gemini(到 Google AI Studio 建一把 API key),也可以填 OPENAI_API_KEY 或 ANTHROPIC_API_KEY;電腦夠力的話裝 Ollama 跑本機模型就不用金鑰。
README 的 Features 清單:AI clip selection 挑 3-7 段、Virality scoring 四個分數、直式裁切、逐字字幕、Hook titles
官方 README 的 Features 段(2026-11-20 截圖):挑 3-7 段、四個分數、臉部置中、逐字字幕、hook 標題。

03第 2 步:clone、寫 .env、docker-compose up -d

照 README 的 Quick Start,先把專案抓下來:

抓專案
git clone https://github.com/FujiwaraChoki/supoclip.git
cd supoclip

在專案根目錄建一個 .env 檔,把兩把金鑰填進去。README 的範例用 Gemini:

.env(README 的範例,用 Google Gemini)
ASSEMBLY_AI_API_KEY=your_assemblyai_api_key
LLM=google-gla:gemini-3-flash-preview
GOOGLE_API_KEY=your_google_api_key

LLM 這一行的格式是「供應商:模型名」。.env.example 列的其他寫法(要搭配對應的金鑰):

換別的 LLM(擇一,來自 .env.example 的註解)
# OpenAI
LLM=openai:gpt-5.2
OPENAI_API_KEY=你的金鑰

# Anthropic
LLM=anthropic:claude-4-sonnet
ANTHROPIC_API_KEY=你的金鑰

# 本機 Ollama(不用金鑰)
LLM=ollama:gpt-oss:20b
README 的 Quick Start:git clone、建 .env 填 ASSEMBLY_AI_API_KEY / LLM / GOOGLE_API_KEY、docker-compose up -d、開 localhost:3107
官方 README 的 Quick Start(2026-11-20 截圖):三行 .env、一行 docker-compose。

然後一行把整套服務(前端、後端 API、worker、資料庫、Redis)拉起來:

啟動(第一次要等幾分鐘)
docker-compose up -d
想看它跑到哪
docker-compose logs -f
Reels 畫面:筆電顯示 README 的 Quick Start,.env 三行被綠框圈起來,docker-compose up -d 被紅框圈起來
Reels 畫面:兩把金鑰寫進 .env,docker-compose 一行就跑。

README 說第一次啟動要幾分鐘。服務健康之後,瀏覽器開 http://localhost:3107,建一個帳號就能開始丟影片。後端 API 在 http://localhost:8000,加 /docs 有互動式的 API 文件。

04第 3 步:丟一支長片,看四個分數挑片

進到 localhost:3107,首頁就是一個輸入框:貼 YouTube 連結、Twitch 或 Kick 的 VOD / clip 連結,或是直接拖一個影片檔進去(直播進行中的不支援,要等它變成 VOD)。送出之後流程是:AssemblyAI 做逐字稿 → LLM 讀逐字稿挑 3-7 段 → 每段打四個分數 → 裁成 9:16、臉部置中 → 上逐字字幕和 hook 標題。處理進度會即時推到瀏覽器。

四個分數怎麼看(README 的四個詞,我把它翻成四個問題):

  1. hook:前幾秒抓不抓人?分數低的片段開頭通常是鋪陳,沒有一句讓人停下來的話。
  2. engagement:看了會不會留下來看完?
  3. value:有沒有料?觀眾看完有沒有帶走一個觀點、一個數字、一個做法。
  4. shareability:會不會想轉給別人?
Reels 畫面:一條寫 podcast.mp4・1:00:00 的影片條分成 14 格,4 格亮綠色打勾,章寫 只留 3-7 段,標示 示意圖
Reels 畫面:一小時影片只留最會爆的 3-7 段(示意圖,不是 SupoClip 的實際畫面)。

剪出來的每一支短片可以進內建剪輯器修剪、分割、合併,匯出時選 TikTok / Reels / Shorts 的預設。README 另外寫了可以連自己的 YouTube、TikTok、Instagram 帳號直接排程發布,還有一個 performance loop:發出去的觀看、按讚、留言、分享會回流,影響之後挑片的方向。這兩項要另外設定,不在 Quick Start 裡。

05進階:全本機、MCP、API

官方自架教學有一段 local 模式:逐字稿改用本機的 Whisper,挑片改用本機的 Ollama,兩把金鑰都不用。.env 這樣寫:

.env(全本機,來自官方自架教學和 .env.example)
TRANSCRIPTION_PROVIDER=whisper
WHISPER_MODEL_SIZE=medium
LLM=ollama:gpt-oss:20b

教學的提醒:YouTube 連結還是要上網才抓得到影片,上傳檔案就完全離線;Linux 的 Docker Engine 要讓 Ollama 監聽所有介面,11434 這個 port 會露出來而且 Ollama 沒有驗證,要自己擋防火牆;Apple Silicon 可以跑,但後端是用 linux/amd64 模擬,不會用到 Apple 的 GPU。

README 還列了兩個入口:mcp/ 資料夾是一個 MCP server,可以從 Claude、Cursor 這類 MCP 客戶端直接叫 SupoClip 剪片;REST API 的金鑰在網頁的 /settings/api-keys 建,文件在 docs/api-reference.md。這篇沒有展開,連結在下面。

06要注意

  1. 授權不是一般的開源授權。2026-11-19 專案換成了自己的「SupoClip Noncommercial Source License v1.0」(授權方 Shiori LLC),GitHub 的授權欄位顯示 Other。它允許的是非商業用途的使用、自架、修改和分享;商業用途要先拿到書面許可,而且 LICENSE 把範圍寫得很寬:公司內部用(包括評估、測試)、接案、剪有營利的頻道或付費活動的影片,都算商用。要商用先寫信 [email protected]。README 說更早的版本保留原本的授權(AGPL-3.0),但那是舊版程式碼,不是現在這份。
  2. 兩把金鑰都是要錢的。AssemblyAI 新帳號有 $50 美金的免費額度(官方定價頁 2026-11-20),之後按音訊時數計費;LLM 每支影片都會呼叫幾次,用 Gemini / GPT / Claude 都會算 token。想零成本就走全本機(Whisper + Ollama),但會慢很多。
  3. 不支援直播進行中的影片。YouTube、Twitch、Kick 都要等變成 VOD 或 clip 才能貼。
  4. Reels 裡 OpusClip 的「$29/月」是 Pro 方案的定價;我們 2026-11-20 截圖時 opus.pro 顯示年繳促銷價 $11.5/月,另一次抓取又只顯示 $29。付費前以當下頁面為準。
  5. 我們沒有在自己的機器上跑 SupoClip。這篇和 Reels 裡的畫面是官方 README、demo 頁和 LICENSE 的截圖,那條一小時的影片條是示意圖;四個分數是 README 寫的,demo 頁本身沒有顯示分數。
  6. 同一間公司(Shiori LLC)也賣代管版:supoclip.com 的 Pro $9.99/月、Creator $24.99/月,還有 iOS app。不想碰 Docker 可以直接用,但那就回到「影片在別人伺服器上」的模式。
  7. 專案更新很快(831 次 commit,前一天還在推),Quick Start 的指令、.env 的預設模型名都可能變。跑之前先看一眼當天的 README。
GitHub 上的 LICENSE 檔:SupoClip Noncommercial Source License v1.0,Licensor Shiori LLC,第 3 條商用要先取得書面許可
官方 LICENSE(2026-11-20 截圖):commit 寫 Adopt the Shiori LLC noncommercial source license,是前一天換的。
Reels 畫面:紙做的瀏覽器顯示 LICENSE 頁,標題和第 3 條被紅框圈起來,紅章寫 只限非商業,小紙條寫 商用:先寫信給 support@supoclip.com
Reels 畫面:只限非商業,商用要先寫信拿許可。

資料來源

延伸閱讀