开发者指南
依赖关系图
交互式生成依赖图:选择任一可编辑项,查看哪些提示词、设定图、静帧和视频会因此需要更新。
每个生成结果都会保存生成时输入内容的哈希值。“待更新”不是预先写入的状态:每次读取时,都会用当前输入重新计算哈希并进行比较;不一致时,就判为待更新。未保存哈希的记录属于未跟踪,不参与这一判断。有版本记录的内容(绿色边框)会保留每次生成的版本,并指定其中一个为当前版本。生成结果还会记录所用提示词或设定图的具体版本,因此判断依据是选用版本是否变化,而不是文字本身是否被编辑。
- 已跟踪
- 未跟踪 · 存在缺口
- 按设计不跟踪
- 一次初始化,之后由你维护
- 保留版本记录
- 可选
- 会变为待更新
- 触发待更新
镜头对白区段
生成内容保留版本记录 — shot_dialogue_sections可选 — 启用配音且镜头中有人说话时shot_dialogue_sections.sourceKey → shots.audioClips镜头对白在整段配音中的时间范围。一段配音会为涉及的每个镜头保存区段:目标镜头直接选用,其他镜头的上下文演绎保留为备选。修改一个镜头,只切换这个镜头的选中区段。选中区段会裁成 shots.audioClips 所用的音频文件,片段 ID 与区段记录 ID 相同。
参与更新判断
更新判断会比较这些输入。任一上游内容改变后,此项就会标记为待更新。
- 镜头原始有声台词的音色 ID、台词、语气和 TTS 模型(sourceKey)
- 使用哪段完整配音,以及其中的起止时间
不参与更新判断
这些内容可以自由修改,不会触发待更新。
- 为其他镜头新生成的配音,其中本镜头的演绎会先保留为备选,不自动选用
- 适配重写后的实际措辞(保存在 spokenLines;sourceKey 仍使用原始台词)
- 裁切文件的缓存键,由整段配音 ID、起止范围和最短补齐时长组成
重新生成此项后,以下内容会标记为待更新
- 按选中版本跟踪 — 清单记录片段 ID(audioClipIds),即区段 ID;选择同台词的另一朗读仅使该镜头视频待更新。
- 经由 片段 — 选中的视频网址。
以下任一项变化后,此内容会标记为待更新
- 计入输入哈希 — sourceKey 基于此镜头自身的有声台词;仅键已不匹配的镜头采用新音频。
- 计入输入哈希 — 音色 ID 是 sourceKey 的一部分,因此更换音色后,会重新录制该音色涉及的镜头。
- 按选中版本跟踪 — 区段是一个 speech 的时间范围;重新生成追加 speech,只移动目标镜头指针。
“全部更新”会重新生成哪些内容
更新范围逐级累加,每一档都包含前面的档位。只更新已有的生成内容,不会补生成尚不存在的素材。
- 1.仅提示词 — 只重写待更新的画面和动态提示词,不生成图片或视频。
- 2.提示词 + 静帧 — 在此基础上,重新生成待更新或提示词刚被重写的静帧;不会首次生成尚不存在的静帧。
- 3.提示词、静帧 + 对白 — 在此基础上,为音色或台词已变化的对白重新配音;不会首次生成对白。视频留到下一档更新,以便先试听新配音。
- 4.提示词、静帧、对白 + 视频 — 在此基础上,重新生成本轮提示词、静帧或对白发生变化的视频,以及已检测到依赖不一致的视频;不会首次生成尚不存在的视频。
- 5.全部内容(含配乐) — 在此基础上,重写待更新的配乐提示词,并在已有音轨时重新生成配乐;不会首次生成配乐。