开发者指南
依赖关系图
交互式生成依赖图:选择任一可编辑项,查看哪些提示词、设定图、静帧和视频会因此需要更新。
每个生成结果都会保存生成时输入内容的哈希值。“待更新”不是预先写入的状态:每次读取时,都会用当前输入重新计算哈希并进行比较;不一致时,就判为待更新。未保存哈希的记录属于未跟踪,不参与这一判断。有版本记录的内容(绿色边框)会保留每次生成的版本,并指定其中一个为当前版本。生成结果还会记录所用提示词或设定图的具体版本,因此判断依据是选用版本是否变化,而不是文字本身是否被编辑。
- 已跟踪
- 未跟踪 · 存在缺口
- 按设计不跟踪
- 一次初始化,之后由你维护
- 保留版本记录
- 可选
- 会变为待更新
- 触发待更新
完整对白音频
生成内容可选 — 启用配音且场景中有人说话时dialogue_speeches.inputHash (the key), dialogue_speeches.turns (voice id and TTS model per turn, readable)通过 Text to Dialogue 一次生成带情绪演绎的整段对白音频。原始完整文件只保留一份,不会为了每个镜头另存整份副本,也不会再拼接。生成时会带上目标镜头前后的对话上下文,让回应衔接前文。记录只追加,不单独指定当前版本;各镜头选用其中对应的时间段。
参与更新判断
更新判断会比较这些输入。任一上游内容改变后,此项就会标记为待更新。
- 按说话顺序发送的有声轮次:镜头 ID、音色 ID、台词、语气
- TTS 模型与稳定度
不参与更新判断
这些内容可以自由修改,不会触发待更新。
- 轮次位置(顺序本身已表达)
- 适配重写后的实际措辞(保存在轮次 spokenText,不改变摘要)
- 各轮次记录的 voiceId、ttsModel 只是键已有内容的可读副本,不影响待更新判断。
重新生成此项后,以下内容会标记为待更新
- 按选中版本跟踪 — 区段是一个 speech 的时间范围;重新生成追加 speech,只移动目标镜头指针。
- 经由 镜头对白区段 — 清单记录片段 ID(audioClipIds),即区段 ID;选择同台词的另一朗读仅使该镜头视频待更新。
- 经由 片段 — 选中的视频网址。
以下任一项变化后,此内容会标记为待更新
- 计入输入哈希 — 按说话顺序发送的有声轮次,包含各自所属镜头。
- 计入输入哈希 — 每轮台词使用的音色是 speech 键的一部分。
“全部更新”会重新生成哪些内容
更新范围逐级累加,每一档都包含前面的档位。只更新已有的生成内容,不会补生成尚不存在的素材。
- 1.仅提示词 — 只重写待更新的画面和动态提示词,不生成图片或视频。
- 2.提示词 + 静帧 — 在此基础上,重新生成待更新或提示词刚被重写的静帧;不会首次生成尚不存在的静帧。
- 3.提示词、静帧 + 对白 — 在此基础上,为音色或台词已变化的对白重新配音;不会首次生成对白。视频留到下一档更新,以便先试听新配音。
- 4.提示词、静帧、对白 + 视频 — 在此基础上,重新生成本轮提示词、静帧或对白发生变化的视频,以及已检测到依赖不一致的视频;不会首次生成尚不存在的视频。
- 5.全部内容(含配乐) — 在此基础上,重写待更新的配乐提示词,并在已有音轨时重新生成配乐;不会首次生成配乐。