开发者指南

依赖关系图

交互式生成依赖图:选择任一可编辑项,查看哪些提示词、设定图、静帧和视频会因此需要更新。

每个生成结果都会保存生成时输入内容的哈希值。“待更新”不是预先写入的状态:每次读取时,都会用当前输入重新计算哈希并进行比较;不一致时,就判为待更新。未保存哈希的记录属于未跟踪,不参与这一判断。有版本记录的内容(绿色边框)会保留每次生成的版本,并指定其中一个为当前版本。生成结果还会记录所用提示词或设定图的具体版本,因此判断依据是选用版本是否变化,而不是文字本身是否被编辑。

  • 已跟踪
  • 未跟踪 · 存在缺口
  • 按设计不跟踪
  • 一次初始化,之后由你维护
  • 保留版本记录
  • 可选
  • 会变为待更新
  • 触发待更新
依赖关系图你编写和设置的内容素材库 · 可选,可跨作品复用设定 · 从剧本或素材库初始化,之后由你维护参考资源提示词渲染结果剪辑从剧本中拆出的场景文本与场景标头。标头、时段、情节节点和连续性标签与文本一起保留版本;镜头需要更新时,可定位到发生变化的具体字段。剧本作品画面的宽高比例。画面比例生成视频时请求的画质档位。分辨率编写提示词的 LLM。剧本模型生成设定图和静帧的模型。图像模型生成镜头视频的模型,也决定可使用的时长档位,以及是否支持对白音频或参考视频。视频模型生成配乐的模型。音乐模型每个镜头的时长(秒),会对齐到视频模型支持的时长档位。镜头时长以已生成静帧为首帧制作视频,或直接根据参考设定图生成。每个镜头都可以单独覆盖作品的设置。首帧模式为每个有台词的角色设计 ElevenLabs 音色,也可在角色卡片上单独调整。角色音色在剪辑中加入配乐。配乐视频模型支持声音时,将对白台词与声音指导附到动态提示词。每次渲染在场景编辑器中选择。音效与对白决定本次生成到哪一步:剧本、参考素材、静帧、视频或配乐。生成终点为生成地点设定图而上传的参考照片(#1695)。数量不限,生成时会使用全部照片。增删照片会撤销当前生成任务的更新资格(claim),避免旧结果覆盖新设定。地点照片An organization or system style in the catalog. Picking it copies its config onto the sequence; the catalog row is never read again.风格库中的风格Extracted from the script at the Script stage, then yours to edit. The character's face, sheet and voice live on the character. Every change is a version. The character belongs to the organization (#2017): every sequence that casts it reads its current version, so an edit from any sequence re-stales the shots of every sequence by derivation, and a stale shot names the field that moved since the version live when it was made. A voice-only character (a narrator) has a row but never a sheet. What a character wears is its looks, not the bible.角色角色的一套造型,由名称、服装,以及随情境变化的发型、妆容或伤痕等细节组成(#2015)。每个角色都有默认造型,各场景可分别选用。编辑会保留版本,并由所有关联作品共享(#2017)。待更新提示会指出具体造型和变更字段,例如“Mia(晚礼服)的服装”。每套造型拥有独立设定图,可跨作品复用。造型Extracted from the script at the Script stage, or one of the organization's locations picked for the sequence, then yours to edit. Every change is a version. The location belongs to the organization (#1695): every sequence that uses it reads its current version, so an edit from any sequence re-stales the shots of every sequence by derivation, and a stale shot names the field that moved.地点通过 @token 引用的道具、效果、声音或视频。剧本阶段检测或手动添加,之后由你编辑。元素保存到作品中的视觉与动态风格快照,可根据剧本自动提炼,也可从风格库中选择。每份快照保留版本,因此待更新提示能够指出具体变更的设置。风格在“剧本”阶段自动为每个镜头分配台词,之后可逐镜头修改。剧本中的台词副本保留模型最初输出,只在镜头尚无台词记录时用作初始值。场景对白按镜头顺序及镜头内台词顺序组合,无需另外维护一份场景级列表。镜头对白台词Turnaround sheet for one look of a character (#2015): one sheet per look some scene wears, and the character's own sheet is its default look's. The face, the sheet and the voice live on the character. The sheet is the look's, so every sequence that casts the character shares it (#2017). Every look other than the default is drawn from the default look's completed sheet and hashes that sheet's selected version. The default look is drawn from the character's reference photo when it has one (#2254), and hashes its URL. A run holds a claim on its look: an edit to anything the sheet reads revokes it, so the run parks its result instead of landing it.角色设定图为有台词的角色设计的 ElevenLabs 音色。视频会绑定所用音色,就像静帧会绑定角色设定图一样。语言模型不读取音色 ID,因此更换音色不会重写动态提示词。每次改动都新增版本并切换当前选中版本;ElevenLabs 音色名额已释放的记录会标为 released,无法再次选用。音色通过 Text to Dialogue 一次生成带情绪演绎的整段对白音频。原始完整文件只保留一份,不会为了每个镜头另存整份副本,也不会再拼接。生成时会带上目标镜头前后的对话上下文,让回应衔接前文。记录只追加,不单独指定当前版本;各镜头选用其中对应的时间段。完整对白音频镜头对白在整段配音中的时间范围。一段配音会为涉及的每个镜头保存区段:目标镜头直接选用,其他镜头的上下文演绎保留为备选。修改一个镜头,只切换这个镜头的选中区段。选中区段会裁成 shots.audioClips 所用的音频文件,片段 ID 与区段记录 ID 相同。镜头对白区段地点的设定图。无论由哪部作品生成,都共用同一张,也可能尚未生成(#1695)。生成任务持有更新资格(claim);依赖输入改变后,该资格作废,结果会保留为备选,不直接成为当前版本。地点设定图生成静帧时使用的文本。单镜头场景由模型撰写;多镜头场景则根据每个镜头的设定组合而成。画面提示词视频渲染使用的文本,与画面提示词一样,多镜头场景由镜头描述组装。动态提示词整部作品共用一份配乐提示词。配乐提示词镜头已渲染的首帧。静帧A shot's grey animatic, drawn from each spec version and stamped with it, start-frame shots included. A sketch of an older spec, or of an older cast, reads stale (#2350). While the sequence is processing, a mismatch is not stale (#2369).Storyboardsketch镜头已渲染的视频。片段生成的配乐。音乐音轨拼接后的 MP4。导出

镜头时长

你编辑的内容

每个镜头的时长(秒),会对齐到视频模型支持的时长档位。

参与更新判断

修改其中任一项,依赖它的内容就会标记为待更新。

  • 镜头秒数用于配乐提示词;镜头时长相加后按模型上限限制,再计入配乐音轨的哈希。
  • 将设置的秒数与已生成视频的时长比较,两者均先对齐到模型支持的时长档位。
  • 将精确秒数与上传视频采用时的时长比较。

不参与更新判断

这些内容可以自由修改,不会触发待更新。

  • 视觉与动态提示词
  • 若只是为容纳已绑定的对白音频而延长镜头,原先对齐后的时长与延长后的时长都按“未变化”处理。

修改此项后,以下内容会标记为待更新

  1. 计入输入哈希 — 逐场景汇总镜头时长。
  2. 计入输入哈希 — 清单时长与当前时长均按模型支持的时长档位对齐比较,流水线再次对齐不再使所有片段待更新(#767)。
  3. 计入输入哈希 — 镜头时长求和并限制上限,得到音轨实际计费长度。
  4. 经由 片段 — 选中的视频网址。

“全部更新”会重新生成哪些内容

更新范围逐级累加,每一档都包含前面的档位。只更新已有的生成内容,不会补生成尚不存在的素材。

  1. 1.仅提示词 — 只重写待更新的画面和动态提示词,不生成图片或视频。
  2. 2.提示词 + 静帧 — 在此基础上,重新生成待更新或提示词刚被重写的静帧;不会首次生成尚不存在的静帧。
  3. 3.提示词、静帧 + 对白 — 在此基础上,为音色或台词已变化的对白重新配音;不会首次生成对白。视频留到下一档更新,以便先试听新配音。
  4. 4.提示词、静帧、对白 + 视频 — 在此基础上,重新生成本轮提示词、静帧或对白发生变化的视频,以及已检测到依赖不一致的视频;不会首次生成尚不存在的视频。
  5. 5.全部内容(含配乐) — 在此基础上,重写待更新的配乐提示词,并在已有音轨时重新生成配乐;不会首次生成配乐。