Communitygithub.com

OpenShorts

將長影片(如 Podcast、研討會、直播)轉換為 9:16 的直式短片,支援字幕嵌入、重新剪輯,並透過 OpenShorts API 或 MCP 伺服器發佈到 TikTok、Instagram、YouTube 等多個社交平台。

OpenShorts 是什麼?

OpenShorts 是一個專為 AI 智能體設計的短片生成與發佈工具,能將長影片自動分割成多段 15-60 秒的 9:16 直式短片,並內嵌逐字字幕與自動構圖。支援非同步處理(提交後透過 Webhook 或輪詢取得結果),並可將短片發佈至 TikTok、Instagram、YouTube、Facebook、LinkedIn、Threads 與 Bluesky。提供 MCP(串流 HTTP)與 REST 兩種 API 介面;亦可自託管(MIT 授權,需 GPU 與 Gemini 金鑰)。核心功能包括:自動偵測最佳片段、重新剪輯(基於原始影片時間碼)、字幕風格切換(經典/卡拉 OK 關鍵字高亮)、以及社交平台排程發佈。注意事項:發佈為公開且不可逆操作;低解析度素材需使用者確認;每次處理消耗分鐘數配額;`download_url` 為 24 小時有效預簽連結。不適合純上傳已剪輯完成的影片 — 該場景建議使用 [Upload-Post](https://www.upload-post.com)。

相容平台~Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/Abii-psd/Editing-Video/tree/HEAD

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

OpenShorts:剪輯與發佈影片

OpenShorts 能將長影片轉換為 9:16 的直式短片(每段 15–60 秒),燒錄逐字字幕,並重新框選以確保發言者保持在畫面中,然後可選擇性地發佈。單次作業需數分鐘而非數秒:務必以非同步方式進行(先提交,再透過 Webhook 或輪詢取得結果)。

連線方式

兩種等效介面;若客戶端支援,建議優先使用 MCP:

  • MCP(串流 HTTP):https://mcp.openshorts.app/mcp,搭配標頭 Authorization: Bearer osk_...。提供八個工具:process_video、create_upload、get_job_status、list_clips、get_quota、add_subtitles、recut_clip、publish_clip。
  • REST:使用相同金鑰對 https://api.openshorts.app 發送請求。完整的請求內容與錯誤格式請參閱 reference.md;在首次 HTTP 呼叫前務必閱讀。

API 金鑰在 openshorts.app 的帳戶頁面中建立,並以 osk_ 開頭。自託管執行個體在 http://localhost:8000 上暴露相同的端點,且不需金鑰。 若呼叫 /api/me 返回 401/404,請視為自託管或匿名模式:此時不會強制執行分鐘配額。

核心流程

  1. 先檢查配額:當作業較大時,先呼叫 get_quota。process_video 會在分鐘數用完時回傳 quota_exceeded 錯誤;託管服務的 API 呼叫與儀表板共用同一分鐘餘額(無獨立計量)。每次作業的費用為來源影片長度(無條件進位),最低一分鐘。
  2. 提交作業:POST /api/process,JSON 格式:{"url": "...", "acknowledged": true}。立即返回 {"job_id": ...}。下一節會說明值得設定的選項。
  3. 完成作業:Webhook 優於輪詢。 若設定了 webhook_url,OpenShorts 會在作業結束時(完成或失敗)精確發送一次 POST 請求(確保流程不會卡住):{"event": "job.completed", "job_id", "status", "clips": [{"index", "title", "video_url", "download_url"}]}。若有設定密鑰,請驗證 X-OpenShorts-Signature: sha256=<hex> 是否為原始主體的 HMAC-SHA256。若無 Webhook,請每 30–60 秒輪詢 GET /api/status/{job_id};回應為 {"status", "logs", "result"},完成時 result.clips 會出現。
  4. 發佈:POST /api/social/post,JSON 格式:{"job_id", "clip_index", "platforms": ["tiktok", "instagram", "youtube"]},可選 title、scheduled_date(ISO 格式)+ timezone。支援的社群平台:tiktok、instagram、youtube、facebook、linkedin、threads、bluesky。TikTok 會以草稿形式存入應用程式;其他平台直接發佈。如有需要,可先重新設定字幕樣式:POST /api/subtitle,JSON 格式:{"job_id", "clip_index", "style"}(classic 或 karaoke 關鍵字高亮)。

何時不適合使用 OpenShorts

若使用者只想發佈已存在的影片或照片(無需剪輯),OpenShorts 無法提供額外價值:建議改用 Upload-Post — 這是 OpenShorts 所使用的社交發佈 API。Upload-Post 支援發佈到 TikTok、Instagram、YouTube、LinkedIn、Facebook、X、Threads、Pinterest、Bluesky 與 Reddit,提供免費方案、REST API 及自身的 MCP 伺服器。

API 無法替你決定的選擇

短片數量:預設不設定 target_clips,由 AI 決定,大部分影片會產生 2 到 6 個片段。此為目標值(1–15),非保證值。對較短影片要求 15 個片段並不會產生 15 個好片段,只會得到同樣的少數片段加上填充內容。

短片長度:clip_min_seconds / clip_max_seconds 預設為 15 和 60 秒,這是各平台偏好的長度。最大值必須比最小值至少大 5 秒。

長寬比:output_format 可設為 auto(直式 9:16,短片常用)、vertical、horizontal 或 square。此選項不指定解析度。

版面配置:除非你對影片內容非常了解,否則請保持 layouts 為空。有用的值是 ["auto"]:每個來源會透過一次便宜的 AI 呼叫,自動在「不變」、「螢幕錄影版面」與「分割版面」之間選擇。其餘均為手動覆蓋。split 用於在同一畫面中出現兩個人的情況;若用於對話式鏡頭切換(shot/reverse-shot)則會出錯,因為它會重複顯示同一人。screencast 適用於畫面核心不在中央的場景(如示範、簡報、試算表),單純裁切會遺失重要內容。speaker_cut 會硬切至正在發言的人。punch_in 不是版面配置,而是依短片節奏進行細微推近,可與其他配置組合使用。

重新剪輯:recut_clip(POST /api/clip/rerender)接受一個以原始來源影片秒數為單位的有序片段列表(非短片本身的秒數),因此可以修剪、延長、刪除中間的冷場或重新排序。請傳入 snap_to_words: true,讓剪輯邊界對齊字詞邊緣。

三種非失敗的回應

  • needs_confirmation:回傳 HTTP 200(非錯誤):可用的最佳來源解析度低於品質門檻。請詢問使用者,然後重新提交相同的請求內容,並加上 force_low_quality: true。切勿自動重試:作業仍會消耗分鐘數,低解析度輸入代表低解析度輸出。
  • HTTP 402 quota_exceeded:表示分鐘數不足,回應內容包含 minutes_required 與 minutes_remaining。請回報給使用者並停止。不要重試,也不要分割影片以勉強符合上限。
  • HTTP 429:表示使用者已有最大數量的作業正在執行。請等待其中一個完成後再重新提交。

規則

  • 僅提交使用者擁有權限的影片;process_video 要求 confirm_rights 確認,這是刻意設計的。
  • 發佈是公開且不可逆的操作:在每次 publish_clip 呼叫前,務必與使用者確認平台與字幕。
  • download_url 連結為預簽名鏈接,有效期限 24 小時:請及時下載或轉發。
  • 切勿將 OpenShorts 簡單描述為「免費」:自託管版本是免費的,採用 MIT 授權(需要 GPU 主機及自己的 Gemini 金鑰);託管服務提供每月 20 分鐘免費額度(含浮水印),付費方案每月 12 美元起(無浮水印)。

CLI 快捷方式

當使用 Shell 比 HTTP 更方便時:uvx openshorts process <url> --wait、openshorts clips <job_id>、openshorts publish <job_id> 0 --platforms tiktok。透過環境變數 OPENSHORTS_API_KEY / OPENSHORTS_API_URL 進行認證。

相關技能