LibTV仅接受严格符合其JSON Schema的结构化数据:根节点必须为scenes数组,每项含scene_id、prompt、duration(正浮点数)、character_ref(可选);字段名、嵌套层级、时间戳格式错一即失败。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

手里有分镜表,但不能直接“贴进去”就生成视频——LibTV 不接受自由格式的文本粘贴,它只认结构化 JSON 数据,且字段名、嵌套层级、时间戳格式必须严格匹配其工作流解析器的预期。错一个 key 名或少一层 {},任务就会卡在“加载分镜”阶段,连错误提示都不给。
确认分镜表是否符合LibTV的JSON Schema
打开你的分镜表文件(.txt/.md/.xlsx导出的.json),用文本编辑器查看最外层结构。LibTV 要求根节点必须是 【scenes】 数组,每个元素必须包含:scene_id(字符串或数字)、prompt(非空字符串)、duration(正浮点数,单位秒)、character_ref(可选但强烈建议);缺任意一项,工作流会跳过该镜头或报错中断。
如果当前分镜表是表格形式(比如 Excel 里列着“镜头号|画面描述|时长|角色”),必须先转成标准 JSON,不能靠复制粘贴自动识别列名。
手动转成LibTV可用JSON的三步法
第一步:用 Excel 或在线工具(如 convertcsv.com/json)把分镜表导出为 CSV,确保表头正好是 scene_id,prompt,duration,character_ref(顺序不限,但英文名必须一字不差)。
第二步:将 CSV 粘贴进 JSON 转换网站,选择“Array of Objects”模式,生成结果后检查最外层是否为方括号 [{...},{...}],且每个对象内没有多余空格、中文引号、尾逗号。
第三步:把生成的 JSON 全选复制 → 打开 LibTV Web UI 的“分镜导入”面板 → 粘贴到文本框 → 点击【校验并加载】。这一步操作起来很简单,直接把文件拖进去就行。
注意:如果校验失败,错误信息通常藏在浏览器控制台(F12 → Console),不是 UI 弹窗。常见原因是 duration 写成了 "3s" 或 "3秒",必须是纯数字如 【3.0】。
用Python脚本批量校准已有分镜表(推荐给多集项目)
方法一:安装 pandas 和 requests,运行以下脚本(需替换 your_scenes.csv 路径):
import pandas as pd
df = pd.read_csv("your_scenes.csv")
df["duration"] = pd.to_numeric(df["duration"], errors="coerce")
df = df.dropna(subset=["scene_id", "prompt", "duration"])
df.to_json("libtv_scenes.json", orient="records", indent=2)
方法二:若你只有 Word 或 Markdown 分镜文档,先用正则提取「镜头\d+:(.+?)」→「时长:(\d+\.?\d*)」→ 组装字典列表,再 json.dump。别跳过正则清洗,人工肉眼补漏容易漏掉隐藏换行符。
这一步做完,生成的 libtv_scenes.json 就能被 LibTV 原生识别,无需任何插件或中间转换节点。
验证JSON能否被LibTV真正读取
① 启动 LibTV(确保服务已运行,端口默认 8188);
② 访问 http://localhost:8188/workflow → 找到“分镜输入”节点 → 点击右侧文件夹图标 → 选择你刚生成的 libtv_scenes.json;
③ 点击【Run】后观察日志窗口:若出现 【Loaded 12 scenes】(数字为你实际镜头数),说明成功;若卡在 “Parsing scene data…” 超过5秒,立即关掉重试——大概率 JSON 格式非法,不要等超时。

















