SuperAPI AI 工具集

gen-ai-local-files

智能体与模型

查看项目

更新于 10-16 03:41

技能介绍

用途:将用户明确指定的本地文件转成托管 URL,以便把该 URL 传给 Picsart MCP 工具(如图像、视频等需要 URL 参数的工具)。仅移动用户点名的那个文件,不用于发现用户有哪些文件,也不做目录扫描。若下一步是 gen-ai CLI 生成,则直接把本地路径传给 -i,CLI 会自动上传,无需此技能。

主要能力与用法:小文件走 picsart_drive(需已连接 picsart-gen-ai 服务器),读取文件并 base64 编码后调用,参数形如 {"action":"upload","url":"data:...","name":...,"type":...},type 依真实文件填 image/video/audio,从 result.url 取托管 URL,无需本地 CLI。大文件用 gen-ai upload,先以 gen-ai whoami 校验认证(Node 22+;未安装可用 curl -fsSL https://picsart.com/gen-ai-cli/install.sh | bash 或 npm install -g @picsart/gen-ai),再执行 gen-ai upload <path> --json,输出 {ok,files:[{path,url,driveUid,error}]},按 path 字段匹配而非数组位置。最后把 URL 传给真正需要的工具,异步操作需及时轮询结果。

限制与注意:gen-ai whoami 仅读磁盘缓存凭证,不代表后续网络命令一定成功;AuthError 属凭证问题,NetworkError 属网络问题,勿混淆去重跑登录。CLI 硬上限 500 MB。CDN MIME 类型仅对固定扩展名正确(.jpg .jpeg .png .gif .webp .heic .avif .mp4 .webm .mov .mp3 .wav .m4a),其余按二进制处理。gen-ai upload/upload-to-drive 的 CDN URL 为编辑临时链接,不持久;picsart_drive 会创建真实 Drive 条目,相对更持久。upload-to-drive 会把非视频文件误标为 VIDEO 并加 .mp4,--folder 参数被忽略。数据: URI 会因 base64 膨胀约 1.37 倍,需预留体积。勿猜测 MCP 工具名,应读取已连接工具列表。