SuperAPI AI 工具集

byted-kickart-video-elements-replace

通用与其它

查看项目

更新于 10-16 09:19

技能介绍

用途

本技能属于视频元素替换类工具,基于一段参考视频和用户提供的替换素材,生成与参考视频高相似度的新视频,可替换的对象包括角色、场景、商品、道具以及声音等内容。当用户提出替换视频元素或生成高相似度视频的需求时使用本技能。

主要能力

技能涵盖两类核心任务:

  • 视频元素替换:识别用户关于「替换角色」「替换场景」「替换商品」「替换道具」「替换声音」「视频元素替换」等意图,读取视频元素替换指南,执行 submit_high_similarity_task_v2 提交任务。
  • 进度查询:识别「查询进度」「查看结果」「生成怎么样了」「好了吗」等意图或具体任务 ID,读取任务查询指南,执行 query_task_v2 解析并输出当前状态或结果。

技能还包含视频参考与替换素材两个前置步骤:视频参考用于获取可直接传给 --ref-video 的素材值;替换素材用于获取按用户顺序排列、可直接传给 --replace-images 的图片列表,其他非图片元素通过 --prompt 描述。

使用方式

所有操作需先完成强制前置校验:读取 CLI 前置校验指南;使用 command -v npm 检查 npm exec 是否可用;命令固定使用 npm exec -y --registry=https://registry.npmjs.org --package @volcengine/kickart-open-mcp@1.1.x -- kickart-open-cli;执行 auth_token 检查登录态,禁止展示、记录或持久化 token。未登录或凭据失效时执行 auth_login 获取授权链接并展示给用户,等待用户明确确认完成网页授权后,单次执行 auth_complete 获取 token,再次检查登录态,禁止自动轮询。npm exec 下载失败或 CLI 不可用时反馈脱敏后的 npm 错误并终止操作,不要求用户提供长期密钥,不读取或回显 OAuth token,禁止直接请求 OpenAPI。

视频元素替换任务需逐步收集参考视频、语言、模型、替换素材、创作提示词,并完成两次提交确认,提交后解析 stdout JSON 输出任务 ID,再通过 query_task_v2 获取结果。

适用场景与限制

参考视频、替换素材及创作内容必须获得合法使用、改编和商业发布授权。submit_high_similarity_task_v2 会创建付费异步任务,不保证幂等,任何失败场景均禁止自动重试;只有用户完成成片信息确认和扣费、合规二次确认后才能提交;无法确认请求是否已受理时不得再次提交。提交成功后返回真实 task_id,不把「已提交」表述为「已生成」。

错误处理需明确告知原因与可执行解决方案,技能给出错误码对照表,覆盖认证失败、参数错误、并发超限、创点不足、套餐权限不足、模板不存在、图片格式错误、媒体 URL 无效、视频时长/分辨率/格式/大小错误、参考视频链接错误、语言参数错误、模板入参校验失败、服务端内部错误、任务不存在、任务超时、任务失败等情形。例如:认证失败需依次执行 auth_login、等待网页授权、执行 auth_complete;创点不足需充值或升级套餐且不得继续提交;语言参数需使用 zh、en、en-us、pt-br、ja、es-mx、id、ms 或 tl;图片需使用 JPEG 或 PNG;视频使用 MP4 或 MOV。具体模板 ID 等参数以官方说明为准,本技能描述中提及 Seedance 2.5 使用 978755330、Seedance 2.0 mini 使用 1028571394。