SuperAPI AI 工具集

export

设计与创作

查看项目

更新于 10-16 03:42

技能介绍

用途:当 Pireel Studio 工作流需要导出、渲染、下载、分享、最终交付或查询导出进度时使用。导出在用户打开的 studio 标签页内本地完成(WebCodecs 客户端合成),文件通过浏览器下载直接保存到本机,不上传、无云端渲染队列、无下载链接。

主要能力与用法:先调用 export_video 启动导出,参数均可选,例如 {"resolution":1080,"fps":30,"format":"mp4"}。分辨率可选 2160/1440/1080(默认)/720/540;帧率 24/30(默认)/60;格式 mp4(默认)/webm/mov。渲染大致实时,3 分钟视频约需 3 分钟。用 track_export 轮询,约每 15 秒一次,运行中返回 {status, progress}。当返回 status: "done" 时会带 filename,浏览器已保存该文件。

定位文件:默认在用户下载文件夹,macOS/Linux 为 ~/Downloads,Windows 为 %USERPROFILE%\Downloads,除非用户配置了其他下载目录或浏览器询问保存位置。先检查是否有匹配文件名的 .crdownload/partial 临时文件,等待其完成(后缀消失、大小稳定)。Chrome 会自动去重命名(如 name (1).mp4),优先取最新匹配基础名的文件而非同名的旧文件。向用户确认绝对路径,环境支持时内联展示视频。相同内容与选项再次导出会即时完成(标签页缓存上次渲染)。

限制与回退:studio 标签页必须保持打开直到导出完成;若工具报告 OFFLINE MODE,请用户先在浏览器中打开项目。若 track_export 报错,原样报告并建议重试一次;反复失败通常意味着页面刷新后源视频 File 丢失,需用户重新打开项目以重连后重试。若完成后在下载文件夹找不到文件,浏览器可能配置为询问保存位置,应询问用户保存位置而非猜测。不要用本地 ffmpeg 自行压平或重编码时间线作为主要交付物,studio 渲染才是唯一事实来源(构图、图形、字幕均在那里合成)。