SuperAPI AI 工具集

21st-video

设计与创作

查看项目

更新于 10-15 07:42

技能介绍

21st Video 是一套配合编码智能体使用的视频创作工具,目标是在用户当前项目中创建和编辑产品、发布、演示或社交视频。它通过一组 video_* MCP 工具与智能体协作,同时保持真实编辑器打开,让用户能看到改动并手动编辑同一个项目。工具输入 schema 是字段、操作名、限制和支持格式的唯一依据。

用途

21st Video 用于从现有项目出发制作视频。开始前应阅读项目 README、相关界面或组件、品牌素材和发布说明,使用真实的产品文案与素材,围绕用户请求确定一个核心信息、合适的宽高比和简短的分镜序列。所有表述都应基于产品本身,并遵守项目说明以及浏览器或计算机使用的限制。可复用用户正在运行的应用,仅在获得授权时启动服务器。

主要能力

工具覆盖视频项目全流程:用 video_list_blocks 或 video_search_blocks 查找相关区块;用 video_create_project 创建项目并指定标题和尺寸(16:9、9:16 或 1:1);用 video_get_doc 获取实际文档、当前修订和编辑器上下文;用 video_apply_ops 分批应用编辑操作;用 video_upload_asset、video_finalize_asset 上传并附加本地 logo、截图或素材;用 video_snapshot 检查代表性帧;用 video_propose_variants 提出 2 到 4 个视觉变体;用 video_export 和 video_export_status 导出并轮询状态。

使用方式

先检查可用的 video_* 工具,若不存在则说明当前连接不提供视频创作能力。创建项目时,template、blockRef、blocks 三者最多选一个,全部省略则创建空项目,并保留返回的 projectId、rev 和 editorUrl。应立即在宿主应用内浏览器打开 editorUrl;该 URL 已选择 Codex 宿主模式并包含短期一次性交接信息,需完整及时打开,不得打印交接令牌或把该 URL 持久化到仓库或日志。最终链接应移除交接片段。编辑时每次应用少量相关操作,提供 projectId、最新 baseRev、ops 和简短标签;每次编辑后检查 applied、kept 和 errors,保留用户的 mine 字段,仅在用户明确要求覆盖特定 id.key 字段时使用 force。遇到修订冲突时,应查看最新文档或调用 video_get_doc,与用户编辑协调后构造新批次,不得盲目重放旧批次或整体替换文档。

适用场景

适合需要从真实产品项目快速产出产品介绍、发布、演示或社交视频的场景,也适合需要用户与智能体在同一可编辑项目中协作、并希望获得多个视觉变体供选择的场景。

限制

快照只覆盖单个帧,不能替代完整播放或音频验证。导出只渲染视频,不会发布到社交媒体。若服务要求登录或导出配额耗尽,应报告返回的要求并保留可编辑项目,不得调用托管 AI 生成来绕过视频工具或配额失败。本地 CLI 渲染、全屏 MCP Apps 编辑器和公开插件提交属于未来选项,不应承诺或调用。