SuperAPI AI 工具集

openart-broll

设计与创作

查看项目

更新于 10-16 09:18

技能介绍

用途

OpenArt B-roll & Motion Graphics (MCP) 用于在视频剪辑流程中生成三类素材:B-roll 补画面、以参考视频为原型的说话头(talking-head)片段,以及带屏幕混合模式的动态图形叠加层(文字或图标动画)。它通过 OpenArt MCP 连接器工作,而不是 API key。

连接方式

OpenArt 没有 API key,技能依赖 OpenArt MCP 连接器,会话中会出现名为 openart_* 的工具。开始时应先验证:

  • openart_account_get → 返回 email、plan、credit 余额。
  • 如果工具不存在,需要让用户在客户端(claude.ai connectors / Claude Code MCP settings)中连接 OpenArt MCP,然后重新检查。

调用契约(每次生成都适用)

  1. openart_model_list — 选择描述与任务匹配的模型;模式很关键:text2video(无参考)、image2video(让精确的首帧动起来)、element2video(主体/身份参考——不确定时选这个)。
  2. openart_model_form_get(model, mode) — 获取该模型该模式的精确字段(duration、aspectRatio、resolution、generateAudio、visualReferences 等),按字段填参数。
  3. openart_model_cost({model, mode, params}) — 报价精确配置。两个真实的计费特点:element2video 的报价不含视频参考附加费(一个 5s 片段报价 300 credits,带一个 14.5s 参考时实际计费 670);text2video 按报价计费。失败/被审核的运行为 0 计费。credit 池与用户在网页界面的活动共享——报价可负担性之前要重新检查 openart_account_get。
  4. 在生成之前,把逐字提示词 + 配置 + credit 预估展示给用户并取得同意。重试和“相同配置”的重掷也包括在内。
  5. openart_generate_video → 返回 historyId(PENDING)。轮询 openart_creation_get(遵守 pollAfterSeconds;一个 5s 片段约需 5–12 分钟)。如果宿主显示自动轮询的结果卡片,不要轮询——结束该回合。
  6. 下载结果 URL,重新编码为密集关键帧(-g 30 -keyint_min 30),抽帧并查看后再放置。

配方 1 — 动态图形叠加(按每句口播)

生成短片,由剪辑师以混合模式叠加在素材上。已验证的配置:text2video、4–5s、分辨率与主片匹配、generateAudio: false、9:16。提示词契约(每个子句都有其作用):

  • 明确声明纯色纯黑背景(#000000),并加上“no background gradients, no vignette, no floor, no ambient glow filling the frame”——只有 BRIGHT 元素(白色/霓虹/品牌色)。用 Screen 或 Add 混合时黑色会消失。
  • 把任何 glow 的范围限定为“hugging the shapes only”(笼统的“no gradients”会与要求的 glow 冲突,模型会丢掉其中一个)。
  • 每个片段一个动作想法,结尾落定或作为无缝脉冲(为剪辑师留出 loop/freeze 空间)。在提示词中写明片段时长,这样“holds for the rest of the clip”才有意义。
  • 文字 ≤ 2–3 个词、全大写、单一字符串——即使在 480p 也能干净渲染;更多会乱。零文字图标片段最安全。在纯图标提示词中加上“no letters, no numbers”,否则模型会自己发明标签。
  • 声明放置区域(top 20% / bottom 25%),但预期它会被忽略——片段会居中返回。没关系:它是抠像浮动层,重新定位图层即可。
  • 追加:“no watermark, no subtitles, no captions”。
  • 验证渲染出的背景确实是纯黑(抽帧)——灰色洗底在 Screen 混合下会像雾。

配方 2 — 身份参考的说话头 / B-roll(element2video)

给模型一段主体参考视频,并指导生成新素材:

  • 参考录入:本地文件通过 openart_upload_pick 组件上传(由用户选文件;注册可能需要数分钟——轮询 openart_upload_list)。可复用 openart_upload_list 中此前的上传;openart_upload_metadata_get(url) 会生成一个可用的 visualReferences 对象——包括来自此前某次生成结果 URL 的。
  • 参考上限会被强制执行:视频参考总时长必须 ≤ 30s——30.04s 的片段会在提交时被拒(input_invalid)。先裁剪。
  • 提示词模式:按槽位指向参考——The man in video 1 says: "<line>" ...——加上镜头/能量指示,以及“No background music, no captions, no on-screen text.”。声音和身份从参考克隆。
  • 音标拼写优于误读:缩写写成字母(“M C P”),日期写成词(“July sixteenth”),难念的名字按其发音写。非英文输出时,按该语言的字母发音来拼。
  • 审核陷阱(byte-plus 模型):输出音频版权检测器可能被口播台词本身触发(output_moderation_blocked / “output audio may be related to copyright restrictions”)。无音乐防护子句修不好它——改写台词。失败的运行为 0 计费,所以迭代成本低。
  • 整条时间线的 b-roll 节拍遵循与 arcads-broll 相同的语法:按剪辑的画幅生成,略长于节拍,匹配调色,裁到最好的 1.5–6s,QA 手部/文字/产品,约 2 次重试预算。

放置

与任何生成媒体相同:在合成卡片中放 <video>(唯一 id,data-start/data-duration)、全幅接管,或在 HyperFrames、CapCut 或任何 NLE 中用 Screen/Add 混合的叠加轨道。

限制

价格与套餐的具体金额、可用模型清单随账户与时间变化,以上仅为文档中出现的示例;本技能依赖 MCP 连接,未连接时无法工作;失败与审核拦截按 0 计费;参考视频总时长上限 30s。关于支持的平台与官方完整功能范围,资料暂未提供更多说明。