开发者指南
依赖关系图
交互式生成依赖图:选择任一可编辑项,查看哪些提示词、设定图、静帧和视频会因此需要更新。
每个生成结果都会保存生成时输入内容的哈希值。“待更新”不是预先写入的状态:每次读取时,都会用当前输入重新计算哈希并进行比较;不一致时,就判为待更新。未保存哈希的记录属于未跟踪,不参与这一判断。有版本记录的内容(绿色边框)会保留每次生成的版本,并指定其中一个为当前版本。生成结果还会记录所用提示词或设定图的具体版本,因此判断依据是选用版本是否变化,而不是文字本身是否被编辑。
- 已跟踪
- 未跟踪 · 存在缺口
- 按设计不跟踪
- 一次初始化,之后由你维护
- 保留版本记录
- 可选
- 会变为待更新
- 触发待更新
镜头对白台词
你编辑的内容保留版本记录 — shot_dialogue_versions在“剧本”阶段自动为每个镜头分配台词,之后可逐镜头修改。剧本中的台词副本保留模型最初输出,只在镜头尚无台词记录时用作初始值。场景对白按镜头顺序及镜头内台词顺序组合,无需另外维护一份场景级列表。
参与更新判断
修改其中任一项,依赖它的内容就会标记为待更新。
- 本镜头有声台词的音色 ID、台词、语气和 TTS 模型(区段 sourceKey、视频 audioSourceKey)
- 无论有无配音,全部台词都计入动态提示词哈希与视频 dialogueKey。
- 每句台词使用的音色(绑定音频元素时跳过 TTS)
不参与更新判断
这些内容可以自由修改,不会触发待更新。
- 不改变音色匹配关系的说话人改名
- 镜头重排:说话顺序读取自镜头,各镜头保留为自身台词裁好的音频。
- 编辑其他镜头台词:该镜头采用新音频,此镜头保留原区段。
修改此项后,以下内容会标记为待更新
- 计入输入哈希 — 按说话顺序发送的有声轮次,包含各自所属镜头。
- 计入输入哈希 — sourceKey 基于此镜头自身的有声台词;仅键已不匹配的镜头采用新音频。
- 计入输入哈希 — LLM 读取和哈希覆盖的内容,使用镜头台词替代剧本台词。
- 计入输入哈希 — 清单中提示词引用的所有台词计入 dialogueKey,有声台词计入 audioSourceKey。
- 经由 片段 — 选中的视频网址。
有关联,但未纳入变更检测
- 一次初始化,之后由你维护 — 镜头列表调用将每句台词分配到镜头,并初始化该镜头台词。
“全部更新”会重新生成哪些内容
更新范围逐级累加,每一档都包含前面的档位。只更新已有的生成内容,不会补生成尚不存在的素材。
- 1.仅提示词 — 只重写待更新的画面和动态提示词,不生成图片或视频。
- 2.提示词 + 静帧 — 在此基础上,重新生成待更新或提示词刚被重写的静帧;不会首次生成尚不存在的静帧。
- 3.提示词、静帧 + 对白 — 在此基础上,为音色或台词已变化的对白重新配音;不会首次生成对白。视频留到下一档更新,以便先试听新配音。
- 4.提示词、静帧、对白 + 视频 — 在此基础上,重新生成本轮提示词、静帧或对白发生变化的视频,以及已检测到依赖不一致的视频;不会首次生成尚不存在的视频。
- 5.全部内容(含配乐) — 在此基础上,重写待更新的配乐提示词,并在已有音轨时重新生成配乐;不会首次生成配乐。