用途:通过火山引擎 KickArt 一键成片服务,生成抖店/抖音商品营销短视频。可提交商品链接或商品 ID,也可上传自定义图片/视频素材,提交异步成片任务,查询进度并同步创作产物。
强制前置:所有操作须先读取 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 调用固定版本。执行 kickart-open-cli auth_token 检查登录态,未登录时执行 auth_login 获取授权链接,用户确认完成网页授权后再执行 auth_complete,禁止自动轮询或在确认前执行。token 不得展示、记录或持久化。
主要任务:进度查询读取任务查询指南,执行 query_task_v2 --task-id <ID> --source kickart_ai_material --auto-publish true;独立素材入库读取素材上传指南,执行 material_pipeline_v2 --file-path <绝对路径>,输出 created.media_id 和 origin_url;一键成片读取一键成片指南,执行 submit_marketing_task_v2;视频参考读取视频参考指南,获取可传给 --user-videos 的素材列表。
使用约束:成片须按指南 Phase 0 收集信息,模型为必选(Seedance 2.5 用 978755842,Seedance 2.0 mini 用 794527234),另需素材与商品信息(四项至少一项)、时长(15/30/45/60 秒)、画幅比例、语言、用途、创意指令、字幕、字幕擦除与明水印等,提交前须展示成片信息并二次确认及合规提示。本地视频限 MP4/MOV、单个 ≤50MB、最多 10 个。
限制:错误需明确原因与方案;认证失败禁止自动重试付费提交;参数、并发、创点不足、套餐权限、商品信息获取失败等错误码各有对应处理建议;服务端内部错误需记录 request_id 联系支持。缺失事实暂未提供。