SuperAPI AI 工具集

pireel-basics

设计与创作

查看项目

更新于 10-16 08:05

技能介绍

用途:这是通过 MCP 在 Pireel Studio(https://pireel.com)中编辑视频时应当最先阅读的基础技能,用于建立核心心智模型并完成工具路由。Pireel Studio 面向口播视频,画布随源素材宽高比变化,工具在打开的 Studio 浏览器标签中实时编辑作品,时间线随操作同步更新。

主要能力与用法:MCP 端点为 https://pireel.com/api/studio/mcp,认证走 OAuth,无 API 密钥,遇到 HTTP 401 需重新登录。可用 create_browser_handoff 获取预登录标签 URL,并必须用自带的可控制内置浏览器打开;该 URL 约 60 秒过期且含登录票据,不要打印给用户,可分享 https://pireel.com/zh/studio/<id> 形式链接。作品包含叠加图块(指标卡、图表、标题等设计图形,标记“待配图”的是占位符)与视频镜头(全屏、punch-in、角落、分屏等取景处理)。存在两套时间基准:源秒(转录时间戳,剪辑后不变)与剪辑后秒(cut_range、split_shot、trim_shot、move_block、resize_block、atSec 等使用),cut_narration 负责桥接转换。每次编辑前先调用 get_state,转录不在其中,需用 read_script 或 extract_asr 获取一次即可。

BYO 生成流程:文本/HTML 由智能体自身模型生成,常用 compose_block_brief → 自行生成 → apply_block,plan_brief → submit_plan → lay_out;add_block、edit_block、add_graphics、analyze_narration 会消耗 Pireel 积分,仅作兜底。

适用与限制:涵盖剪辑、字幕、主题、镜头取景、撤销与本地媒体导入等路由操作。extract_asr 与 analyze_visual 可能耗时数分钟,缓慢不等于失败,不要重试;图块类工具有 10 分钟桥接超时,即时操作 60 秒超时。标签关闭时数据级工具可离线运行,依赖视频的工具需先自行打开标签。请求含糊或引用了不存在的元素时应先提一个简短澄清问题。涉及大幅精简或重构前需先确认目标长度与保留内容。其余收费与价格等细节资料暂未提供。