SuperAPI AI 工具集

photo-slideshow

设计与创作

查看项目

更新于 10-30 20:04

技能介绍

用途:把 N 张照片按顺序做成一段宣传片/幻灯片场景,每处接缝可设转场,并可叠加标题。文档示例在 1080x1920 下验证并渲染。

主要能力与使用方式:

  1. 先探测照片:对每个照片 URL 调用 picsart_media_probe,在资产上声明 width/height;这些数值决定每张照片的适配方式,并让 blur_fill 在宽高比已匹配时跳过填充。
  2. 片段轨道:一个 track 层容纳照片片段,首尾相接;需要非硬切的接缝在 transitions[] 中按 between(间隙索引,0 表示片段 0 与 1 之间)添加转场。轨道时长为片段时长之和,转场不缩短总长,其窗口以接缝为中心。每个窗口从相邻片段各取一半时长,两侧取走的时长之和必须落在片段内,否则校验会以 transition_window_exceeds_clip 拒绝。转场可选值需读取 picsart_scene_capabilities({ sections: ["transitions"] }),闭集参数只接受枚举值;默认用 crossfade,方向性转场(如 slide)用在需要“下一张”语义的接缝。所有接缝相同可用 scene://montage 模板;接缝不同或转场带参数时手写轨道。
  3. 适配:竖图且 cover 裁掉不到约五分之一时用 "fit": "cover",主体偏心可加 align;方形或横图等差异明显时不设 fit,加 looks: [{ "look": "blur_fill", "params": { "blur": 8, "resFactor": 10, "dim": 0.25 } }],整张照片 contained,边缘由模糊的 cover 副本填充。look 写在片段自身,片段保留转场。
  4. 标题与时间:文字层放在轨道上方,入场可保留为 content.animations 中的预设引用,或用 picsart_scene_apply_preset(textAnimation:<name>)固化,两者渲染一致。入场从图层本地时间 0 开始,文字动画预设不带延迟;要更晚出现就移动图层 start,并同时调整 duration。图层关键帧默认按合成时间计;关键帧落在图层窗口外会触发 keyframe_time_outside_window 警告。示例标题作为开场卡在第一张照片上,图层在 0.5+2.1=2.6s 结束,早于首个接缝窗口 2.7s 开启。长标题用 wrapWidth 声明换行列宽。
  5. 可读性:白字压在照片上时,对比度取决于最亮的那张照片;示例中无处理为 1.6:1,投影为 2.0:1,渐变遮罩或底板为 4.0:1。投影只定义边缘,不能保证亮照片上的可读性;可能落在亮照片上的标题应加遮罩或底板。遮罩是与标题同窗口、两端淡入淡出的全宽形状层;9:16 社交输出常见约定是文字保持在 x 90–990、y 250–1540。
  6. 字体:font.family 是名称,用 picsart_scene_fonts({ query }) 查目录并把返回的 key 填入;传 licenseType: "commercial" 只列商用字体。渲染器无系统字体,CSS 名称如 Inter 会被拒绝并列出最接近的 key。目录缺少的字体可从 live.fonts 取 asset,加入 assets 后按 id 引用;直接放 .ttf URL 也能渲染但会丢失字体名。
  7. 精简上下文:场景先写一次,之后用 picsart_scene_patch 按 id 打补丁(如 set title 的 content/text),补丁返回的 scene 传给下一工具;成功补丁已通过校验,手改前无需再次校验。
  8. 验证:用 picsart_scene_contact_sheet 的 times 一次查多个决定时刻,resolution 设为场景 composition 的宽高;不设 resolution 会返回缩略图,不适合判断位置。示例 12 个时刻分两次调用,覆盖标题显现(无、部分、完整)、各片段中点、标题与遮罩在首个接缝窗口前消失、接缝中心转场进行中、以及末帧(duration − 1/fps)停在照片而非黑屏。接缝中心只显示一张照片即为硬切,重写前先检查转场取值。

适用场景:照片宣传片、幻灯片、开场标题卡等 9:16 社交视频式场景。

限制:时间、转场窗口、模糊填充、字体、对比度等规则均以文档所述校验与渲染行为为准;具体平台支持与导出细节暂未提供。