短视频和教学动画制作常需要先把课程内容拆成分镜，再分别生成图片、视频和剪映草稿。手工整理提示词、素材和任务记录，容易出现镜头缺失、路径混乱和结果不可追踪。
StoryBoard 用于在 Tarui 桌面端生成分镜提示词、维护任务目录、批量生成图片和视频，并将可用素材导出为剪映草稿，适合把脚本文案推进成可编辑的视频生产流程。
文章目录
模块定位
StoryBoard 是 Script 脚本工具中的故事板制作工作台，主要服务于"课程或脚本内容 -> 分镜 JSON -> 图片首帧 -> 视频片段 -> 剪映草稿"的生产链路。它不是单纯的图片生成页，而是把 LLM、图片生成、视频生成、素材目录、提示词目录、任务日志和剪映导出集中到一个流程中。
| 定位项 | 内容 |
|---|---|
| 所属板块 | Script 脚本工具 |
| 核心任务 | 生成分镜提示词，导入分镜脚本，批量生成图片和视频，导出剪映草稿 |
| 适合用户 | 教学动画制作、短视频脚本分镜、AI 图片视频批量生产和剪映草稿制作用户 |
| 输入内容 | 项目目录、任务目录、素材目录、提示词目录、剧情关键词、图片参数和视频参数 |
| 输出结果 | 分镜 JSON、图片结果、视频结果、任务日志、执行日志和剪映草稿 |
| 使用前提 | API 配置可用，项目目录和素材目录已准备，任务目录可写入 |
项目配置
StoryBoard 的配置重点是服务商、目录、分镜提示词、图片视频参数和任务日志。用户开始前应先在个人中心完成 API 设置，再回到 StoryBoard 的配置管理中选择 LLM 厂商、图片厂商和视频厂商。使用本地 Codex 或本地 Grok 时，需要先确认对应本地服务已经启动；使用 AI万物或云雾时，需要确认 API Key、模型和网络状态可用。
| 配置项 | 配置内容 | 使用说明 |
|---|---|---|
| LLM 厂商 | AI万物、Codex、本地 Grok、DeepSeek、OpenAI、Gemini 等 | 用于生成分镜 JSON 和剧情结构，默认可选择本地 Codex |
| 图片厂商 | AI万物(图像)、云雾(图像) | 用于按每个镜头的图片提示词生成首帧或画面 |
| 视频厂商 | 本地 Grok、云雾 | 用于按每个镜头的视频提示词生成视频片段 |
| 图片参数 | 分辨率、比例、方图、横图和竖图 | 影响图片输出尺寸和后续视频画幅 |
| 视频参数 | 模型、宽高比、基础视频时长、延长最小秒数、最大延长次数、分辨率和风格预设 | 影响视频生成时长、清晰度和风格 |
| 项目目录 | 课程或脚本根目录 | 任务目录从项目目录下的文件夹中选择 |
| 任务目录 | 当前需要生成故事板的任务文件夹 | 分镜、图片、视频和导出结果会写入该目录 |
| 素材目录 | 人物、宠物、物品、参考图等素材 | 分镜生成时会从素材目录中选择可用参考图 |
| 提示词目录 | start_prompt.md 和 00.xxx.md 到 09.xxx.md 等提示词文件 |
生成分镜前会读取提示词目录中的模板和附件 |
| 安全要求 | API Key、客户脚本、私有素材、课程内容和本地隐私路径 | 截图时使用测试素材并遮挡真实密钥和路径 |
项目说明
项目说明页用于查看 StoryBoard 的模块介绍、文字教程、视频教程和资源入口。首次使用时，用户应先在这里了解 StoryBoard 的整体用途，再进入配置管理完成服务商和参数配置。
StoryBoard 的关键不是直接生成视频，而是先把内容拆成稳定的分镜数据。分镜 JSON 正常生成后，后续图片、视频和剪映导出才有可靠的镜头顺序、参考图和提示词来源。
配置管理
配置管理页用于维护 LLM、图片和视频三个生产环节的服务商与参数。页面顶部会提示服务配置需要在个人中心修改，因此如果 API Key、模型、IP 或端口不正确，应先回到个人中心的 API 设置中处理。
LLM 区域用于选择分镜生成模型，并设置最大输出 Token、Temperature、Top P 和 Top K 等参数。本地 Codex 和本地 Grok 会显示服务状态和启动按钮，用户应先确认状态为运行中，再进入模板设置生成分镜提示词。
图片区域用于选择图片生成厂商，并设置分辨率和比例。当前图片生成常用 AI万物(图像)或云雾(图像)，生成失败时通常需要检查 API Key、模型能力、图片比例和参考图是否可读取。
视频区域用于选择视频生成厂商，并设置模型、宽高比、基础视频时长、延长参数、分辨率和风格预设。本地 Grok 常用于视频生成，云雾视频会提交后台任务并轮询回填结果。视频任务耗时较长，提交后应结合任务日志和执行日志观察状态。
| 配置区域 | 常见字段 | 使用建议 |
|---|---|---|
| LLM 配置 | 厂商、模型、最大输出 Token、Temperature、Top P、Top K | 先用单篇任务验证分镜 JSON 是否可解析 |
| 图片配置 | 厂商、模型、API Key 状态、分辨率、比例 | 先生成一张图片确认参考图和提示词有效 |
| 视频配置 | 厂商、模型、宽高比、时长、延长次数、分辨率、风格预设 | 先单条生成视频，再执行批量视频 |
| 本地服务 | 本地 Codex、本地 Grok 的启动、停止、检测状态 | 本地服务未运行时不要直接提交任务 |
模板设置
模板设置页用于生成 StoryBoard 分镜提示词。页面左侧显示 LLM 对话、图像生成和视频生成三个模板配置，右侧用于选择项目目录、任务目录、素材目录、提示词目录和剧情关键词。
项目目录是课程或脚本根目录，任务目录通常是项目目录下某个具体任务文件夹。素材目录用于放人物、宠物、物品和参考图，提示词目录用于放 start_prompt.md 和分镜生成所需的提示词附件。目录准备好后，用户可以选择剧情关键词，例如修真、宫斗宅斗、快穿、悬疑推理、末世、权谋历史、玄幻、电竞游戏、科幻、穿越、群像剧、言情、轻小说风格、追妻火葬场、都市异能或重生。
模板设置提供"单篇"和"全部"两种生成范围。单篇只处理当前任务目录，适合测试；全部会遍历项目目录下的任务文件夹，适合确认模板稳定后批量生成。点击"生成提示词"后，页面会根据 start_prompt.md、目录路径、剧情关键词、画幅和视频时长生成提问提示词，用户可以复制提示词，也可以让工具继续执行生成。
| 设置项 | 使用说明 |
|---|---|
| 项目目录 | 用于扫描任务目录，建议保持一个课程或项目一个根目录 |
| 任务目录 | 当前生成分镜的具体目录，结果会写入该任务 |
| 素材目录 | 放置可引用的参考图素材，素材命名越规范，分镜引用越准确 |
| 提示词目录 | 放置 start_prompt.md 和分镜生成附件，影响最终 JSON 结构 |
| 剧情关键词 | 决定剧情包装方式和镜头节奏 |
| 生成范围 | 单篇适合测试，全部适合批量任务 |
| 提问提示词 | 自动拼装后的完整提示词，可复制或直接用于分镜生成 |
任务日志
任务日志页用于查看图片生成、视频生成、剪映导出和后台任务的执行记录。表格包含状态、任务名称、模型、创建时间和输出结果，用户可以通过这些信息判断任务是否成功，失败时也能定位到对应镜头或模型。
批量任务执行后，不建议只看页面预览结果，应回到任务日志确认每条任务是否完成。对于云雾视频这类后台任务，任务日志会比页面预览更适合观察提交、轮询、成功或失败状态。
故事板
故事板页是执行图片、视频和剪映导出的核心页面。顶部可以选择图像比例，包含方图、横图和竖图；也可以选择任务名称并打开任务目录。右侧操作按钮包含导入脚本、批量图片、批量视频、刷新数据和导出剪映。
导入脚本用于粘贴分镜 JSON。页面支持从剪贴板读取 JSON，并保存覆盖当前任务的分镜提示词文件。导入前应确认任务目录和提示词目录已经设置，否则保存位置不明确。
故事板表格按镜头展示参考图、图片结果和视频结果。每个镜头都可以查看参考图、复制参考图信息、打开图片提示词、复制提示词、粘贴或导入图片、清空结果、下载结果、单条运行图片或视频任务，并查看历史记录。视频列同样支持提示词、复制、导入或粘贴、清空、下载、运行和历史。
批量图片会按分镜行生成图片结果，批量视频会使用已有图片或视频提示词提交视频生成。执行批量任务前，应先确认分镜行已经加载、参考图可读取、图片提示词和视频提示词没有空值。导出剪映会把已生成的图片或视频整理成剪映草稿；如果没有配置剪映草稿目录，工具会尝试导出到项目 video 目录下的 jianying_drafts。
| 故事板操作 | 使用说明 | 结果确认 |
|---|---|---|
| 导入脚本 | 粘贴或读取分镜 JSON，保存到当前任务目录 | 分镜行刷新后正常显示 |
| 批量图片 | 按每个镜头的图片提示词生成图片 | 图片列出现预览和输出路径 |
| 批量视频 | 按每个镜头的视频提示词生成视频 | 视频列出现预览或后台任务状态 |
| 单条运行 | 对某个镜头单独执行图片或视频生成 | 当前镜头状态变化 |
| 粘贴导入 | 从剪贴板或本地文件补充图片、视频结果 | 媒体预览可打开 |
| 历史记录 | 查看同一镜头的历史图片或视频结果 | 可回看旧输出路径 |
| 导出剪映 | 将可用图片或视频写入剪映草稿 | 任务日志显示成功和草稿路径 |
执行日志
右侧执行日志用于显示当前 StoryBoard 任务状态，包括进行中、完成、失败和最近任务记录。批量图片、批量视频或导出剪映后，执行日志可以快速判断是否还有任务正在运行。
当页面显示任务失败时，应结合右侧执行日志和任务日志一起判断。图片失败通常需要检查图片厂商、API Key、参考图和提示词；视频失败通常需要检查视频厂商、模型、时长、宽高比和后台任务状态；剪映导出失败通常需要检查是否已有图片或视频素材，以及剪映草稿目录是否可写入。
操作流程
StoryBoard 的操作流程可以按"配置服务商、准备目录、生成分镜、导入或刷新故事板、批量生成图片视频、导出剪映草稿"来理解。首次使用建议只选择一个任务目录做单篇测试，确认分镜 JSON、图片生成、视频生成和任务日志都正常后，再切换到全部任务或批量执行。
否
是
否
是
否
是
否
是
否
是
进入 StoryBoard
查看项目说明
进入配置管理选择 LLM、图片和视频厂商
服务商和 Key 是否可用
回到个人中心补充 API、模型、端口或启动本地服务
进入模板设置选择项目、任务、素材和提示词目录
目录和提示词是否完整
补充素材目录、任务目录或 start_prompt.md
选择剧情关键词和生成范围
生成分镜提示词或执行分镜生成
进入故事板刷新或导入分镜 JSON
分镜行是否正常加载
检查 JSON 格式、任务目录和提示词目录
先单条生成图片或批量图片
图片是否成功
查看执行日志和任务日志修正图片配置
单条生成视频或批量视频
视频是否成功
查看任务日志修正视频厂商和参数
导出剪映草稿并确认输出路径
应用场景
StoryBoard 适合需要把脚本文案转换为可生产视频素材的工作流。它可以先通过 LLM 生成结构化分镜，再按每个镜头生成图片首帧和视频片段，最后导出剪映草稿继续编辑。对于教学动画，StoryBoard 能把知识点、人物、宠物、物品和教学线索组织到镜头中；对于短视频生产，它能把剧情关键词和素材目录结合起来，稳定生成同一风格的画面和视频；对于批量任务，它通过任务日志和执行日志降低排查成本。
| 应用场景 | 使用方式 | 关联功能 | 输出结果 |
|---|---|---|---|
| 教学动画分镜 | 选择课程任务目录、素材目录和剧情关键词，生成 12 条分镜 | 模板设置、故事板 | 分镜 JSON 和镜头提示词 |
| 图片首帧生产 | 读取参考图和图片提示词，单条或批量生成图片 | 故事板、任务日志 | 图片预览和输出路径 |
| 视频片段生成 | 使用图片结果和视频提示词提交视频任务 | 故事板、执行日志 | 视频片段和后台任务状态 |
| 素材手工补齐 | 对单个镜头粘贴、导入、清空或下载图片视频 | 故事板 | 可人工修正的媒体结果 |
| 剪映草稿制作 | 将已生成的图片或视频导出为剪映草稿 | 故事板、任务日志 | 可继续编辑的剪映草稿 |
| 批量任务排查 | 通过任务日志查看状态、模型、时间和输出路径 | 任务日志、执行日志 | 失败原因和可修正方向 |
总结
StoryBoard 的使用顺序是先完成个人中心 API 设置和本地服务检查，再在配置管理中选择 LLM、图片和视频厂商，随后准备项目目录、任务目录、素材目录和提示词目录。分镜生成成功后，进入故事板先单条验证，再批量生成图片和视频，最后通过任务日志确认结果并导出剪映草稿。
更多内容请访问：
| 文章链接 | 内容描述 |
|---|---|
| AIGC工具箱安装与使用 | 介绍 AIGC 工具箱的安装流程、基础配置方式以及首次启动后的使用说明。 |
| AIGC工具箱功能应用模块 | 介绍工具箱内各功能模块的分类、入口位置和实际使用方式，便于快速了解整体能力。 |
| AIGC工具箱错误解决办法 | 汇总工具箱在安装、启动和使用过程中常见的报错情况，并提供对应的排查与解决方法。 |
| AICG常用API获取方式 | 介绍桌面工具使用过程中所需 API 密钥的获取方式，便于完成接口配置与功能接入。 |