该技能面向“从媒体 URL 到渲染文件”的快速链路,由三个固定的工具调用链组成。所有工具都通过 URL 接收媒体,不读取本地路径、file:// URI 或内联文件字节,这类来源会在渲染前被拒绝。若文件只在用户设备上,需调用 picsart_drive_upload_ask 打开拖拽上传;该调用本身不返回 URL,文件 URL 会在用户下一轮以组件上下文或消息形式出现,需先读取再继续。调用时可传入 detected_files(能看到文件名时)和 known_urls(提供本次对话中已生成的 URL)。
一、把多段视频合并为一个文件 montage 模板按顺序依次播放各片段并渲染为一个文件。步骤:
- 逐个探测片段:对每个片段 URL 调用一次 picsart_media_probe 获取宽、高、时长;若先前工具结果已给出确切尺寸和时长可跳过。缺少 durationSeconds 表示时长未知而非 0,应按探测结果中的说明处理。
- 构建参数:将片段写成 JSON,每个片段一个对象,含 uri、width、height、duration(来自探测),可选 in 和 out(以秒计的裁剪)、fit(cover、contain 或 fill)和 align(九种位置之一,如 top left 或 center,默认 center)。然后运行 scripts/montage_params.py,示例:python3 scripts/montage_params.py --transition crossfade --transition-duration 0.4 clips.json。脚本会输出完整的 picsart_scene_apply_template 参数:uri 为 "scene://montage",mode 为 "bootstrap",parameters 含 transition、transitionDuration 和 clips。不要传 --width 和 --height,画布默认匹配最大片段、帧率跟随片段;仅在刻意改变宽高比或尺寸时同时传入两者。要减小输出文件,可使用 picsart_scene_export 的 resolution。传 --transition "" 表示硬切。当片段形状与输出不一致(如竖屏与横屏混排)时使用 fit 和 align。
- 无 shell 时手写脚本输出:模板的 clips 不接受上述输入形状,每个 clip 由 duration(out 减 in)和一个 content 对象组成,content 携带探测到的 asset、裁剪、fit 和 align。硬切为 transition: "" 且 transitionDuration: 0。
- 引导场景:原样调用 picsart_scene_apply_template,参数已完整,无需查询 schema 或模板。合成时长等于各片段时长之和,切勿手动设置。
- 校验:对返回的场景调用 picsart_scene_validate。
- 可选可编辑工程:picsart_scene_translate 返回完整引擎工程,转场接在接缝处;只需文件时可跳过。
- 渲染:调用 picsart_scene_export,mediaType 为 "mp4",返回任务回执,按 picsart-video-rules 跟进直至报告 urls(一个合并文件)。 注意:montage 是顺序的,每段从前一段结束处开始;若需画中画等同时播放的图层,应使用 picsart_scene_patch 编写重叠图层。渲染长度不会对齐帧网格,精确小数裁剪的合成可能比目标短一两帧,属正常现象。
二、从场景抽帧 需先有有效场景(模板返回的或用 picsart_scene_patch 编写的),先调用 picsart_scene_validate 校验,再调用 picsart_scene_contact_sheet,二选一传入 times(精确时间戳)或 frames(等间隔帧数),可传 resolution。返回的帧含时间和 URL,是低分辨率预览而非交付物。
三、将场景渲染为文件 需先有有效场景;本技能合并任务构建的场景无需额外检查,否则用 picsart_scene_capabilities 依次查看 ["schemaSummary"] 和 ["schema:<Name>"],模板则查看 ["template:<uri>"] 确认形状。先调用 picsart_scene_validate 校验,再调用 picsart_scene_export,传入 mediaType(mp4、png 及其他所列格式),可选 resolution、fps、duration、startTime。传入 fileName(取自场景主题的短名),使保存到 Drive 的文件有真实名称。默认返回任务回执,按 picsart-video-rules 跟进直至报告 urls。导出在服务器端渲染,需要已登录用户;调用前需遵守 picsart-video-rules 关于费用的规则。