开发者指南
依赖关系图
生成流程的交互式地图:选择任意可编辑内容,查看哪些提示词、设定图、静帧和视频片段会过期。
每个生成产物都会保存生成时输入内容的哈希值。系统不会直接设置“过期”标记:每次读取时,都会根据当前输入重新计算哈希并进行比较。哈希不一致即为过期。没有保存哈希的记录属于未跟踪,因此永远不会过期。带版本的内容(绿色边框)会将每次生成结果保存为一条记录,并通过指针选择其中一个版本。渲染产物会记录所使用的提示词或设定图版本,因此选择其他版本才会使其过期,单纯编辑文本不会。
- 已跟踪
- 未跟踪,存在缺口
- 按设计不跟踪
- 生成一次初稿,之后由你维护
- 已版本化
- 可选
- 将会过期
- 导致其过期
声音
生成产物可选 — 为有对白的角色开启声音时characters.voiceId → VideoManifestEntry.audioSourceKey为有对白的角色设计的 ElevenLabs 声音。它与视频片段的绑定方式,类似角色设定图与静帧的绑定;LLM 不会读取声音 ID,因此更换声音不会重写动作提示词。
参与计算
检查过程会比较这些内容。更改任一上游内容,此项就会过期。
- 声音 ID(与台词、语气和 TTS 模型一起写入视频片段清单的 audioSourceKey)
不参与计算
可以自由更改这些内容,不会导致任何内容过期。
- 声音描述编辑(“生成声音”会释放旧声音并重新设计)
- 角色设定编辑
重新生成此项后,以下内容会过期
- 记录在输入哈希中 — 声音 ID 会纳入 audioSourceKey;LLM 不会读取它
- 经由 视频片段 — 所选视频片段 URL
以下任一内容变化时,此项会过期
无。此项永远不会被标记为过期。
已关联但未跟踪
- 按设计不跟踪 — 声音描述会根据角色设定生成一次初稿
- 按设计不跟踪 — 选角时会将素材库声音复制到角色,而不是重新设计
- 按设计不跟踪 — 决定是否设计声音
“全部更新”会重新生成什么
更新深度会逐级累加,每一级都包含其上方的级别,且任何级别都不会创建尚不存在的产物。
- 1.仅提示词 — 重写过期的视觉和动作提示词,不执行渲染。
- 2.提示词 + 图像 — 还会重新渲染已过期或提示词刚被重写的静帧,但不会生成首个静帧。
- 3.提示词、图像 + 视频 — 还会重新渲染本次任务中提示词或静帧已变化,或清单已经不一致的视频片段,但不会生成首个视频片段。
- 4.全部内容(含音乐) — 还会重写过期的音乐提示词;如果音轨已存在,则随后重新生成音轨,但不会生成首个音轨。