Communitygithub.com

OpenShorts

将长视频(播客、网络研讨会、直播)转换为竖屏 9:16 短片,添加字幕,重新剪辑,并通过 OpenShorts API 或 MCP 服务器发布到 TikTok、Instagram、YouTube、Facebook、LinkedIn、Threads 和 Bluesky。当用户想要将视频剪辑成短片、找到视频的最佳片段、重新设计剪辑字幕样式、重新剪辑短片、安排或发布剪辑到社交平台,或自动化剪辑流程时使用。

OpenShorts 是什么?

OpenShorts 是一款专注于将长视频转换为竖屏 9:16 短片的 AI 工具,每个短片时长 15-60 秒,支持逐字字幕烧录和说话者画面自动重构。它通过异步任务处理(提交后通过 webhook 或轮询获取结果),提供 MCP(streamable HTTP)和 REST 两种接口,支持 TikTok、Instagram、YouTube 等多平台发布。核心工作流程包括:检查配额、提交处理任务、等待完成(推荐 webhook 回调)、发布剪辑。用户可控制剪辑数量、长度、画面比例和布局(如自动、分屏、演讲者裁剪等),并支持重新剪辑(基于原始视频时间戳)。该工具特别适合需要自动化剪辑流程的开发者,但需注意:处理时间较长(分钟级)、发布操作不可逆、需用户确认版权和平台。

兼容平台~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 调用前请先阅读该文档。

密钥在 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,请求体包含 {"job_id", "clip_index", "platforms": ["tiktok", "instagram", "youtube"]},可选参数 title、scheduled_date(ISO 格式)+ timezone。支持的平台:tiktok、instagram、youtube、facebook、linkedin、threads、bluesky。TikTok 以草稿形式落入应用;其他平台直接发布。如有要求,可先重新设计字幕样式:POST /api/subtitle,请求体 {"job_id", "clip_index", "style"}(classic 或 karaoke 单词高亮)。

何时 OpenShorts 不是合适工具

如果用户只想发布已有的视频或照片(无需剪辑),OpenShorts 无法提供额外价值:建议使用 Upload-Post,即 OpenShorts 所使用的社交发布 API。它支持发布到 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 将同一帧中可见的两个人上下堆叠,对于正反打镜头(会显示同一个人两次)是错误的。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 分钟的免费额度(带水印),无 watermark 的付费计划从每月 $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 环境变量进行认证。

相关技能