SuperAPI AI 工具集

xyq-marketing-skill

营销与增长

查看项目

更新于 10-15 21:35

技能介绍

用途:调用小云雀公开营销 API,按用户自然语言指令生成剧情广告、品牌大片或达人带货营销视频,覆盖上传素材、提交成片、查询进度、下载结果与查询积分。剧情、品牌、带货等类型由用户指令表达,不虚构 mode、template 等参数;普通生视频、画布编辑、短剧创作应使用各自已有 Skill,不用本技能替换为一次普通生视频。

环境与用法:需 Node.js 16+ 及支持 marketing 命令的 @pippit-dev/cli,脚本位于 {baseDir}/scripts/marketing.js。先运行 pippit-tool-cli marketing --help 检查;缺失时执行 npm install -g @pippit-dev/cli@latest 后复查,仍不支持则报告版本阻塞。调用复用 CLI 登录态,执行前运行 pippit-tool-cli status 读取 JSON 的 logged_in;未登录时运行 pippit-tool-cli login 由用户在浏览器授权。不要索取或记录 access_token、Access Key。

常用命令:node scripts/marketing.js upload --file /path/to/product.png;generate --request 请求文件.json --dry-run(默认离线预览);--execute 提交;query --thread-id THREAD_ID --run-id RUN_ID --wait --max-wait 900 --output-dir 目录;balance 查询积分。请求为 UTF-8 JSON,message 保留用户原指令,general_agent_settings.video_model 必填;上传后保留 data.pippit_asset_id,远程素材需先取得本地文件,不能把 URL 或路径写入 asset_ids。--timeout 为单请求时限(秒,默认 60)。

状态与限制:ret 为 0 或字符串 0 才表示业务成功;run_state 1/2/7 进行中,3 完成,4/5 失败或取消,6/9 等待用户交互,8 程序中断。退出码 4 须停止轮询并在同一会话处理确认后查询最新 Run,不能用旧 Run 重复确认。提交成功或拿到网页链接不等于交付完成。下载只新建文件不覆盖,下载不带鉴权头;生产 API 固定为 https://xyq.jianying.com,不跟随鉴权请求重定向。成功下载只证明取得字节,不代表创意质量验收。