用雾象把文字主题生成带旁白的动画短片

雾象（Fogsight）是一款免费开源的 AI 动画生成工具，解决的问题很具体：把一句抽象的文字描述变成一段能直接看的动画。你给它一个主题或概念，比如「冒泡排序」「熵增定律」，它会自动生成包含旁白、视觉元素和动态效果的动画作品，把文字脚本到成片的编排交给大模型完成，不需要手动逐帧设计。它同时提供语言用户界面（LUI），生成之后可以用自然语言继续提要求，多轮调整到满意为止。适合教育工作者做教学动画、科普创作者做原理演示、企业培训师做知识分享，也适合想拿它做二次开发的技术人员。想先了解工具的基本情况，可以看站内的 雾象 条目。

需要先说明一点：雾象的动画质量高度依赖背后接入的大模型，同一段主题在不同模型下产出的脚本、旁白和画面组织会明显不同。所以下面的流程里，模型选择与密钥配置不是可跳过的准备工作，而是决定成品效果的关键一步。

准备工作

确认运行方式

雾象是开源项目，需要把项目代码取到本地并安装依赖后运行，不是打开网页就能用的托管服务。因此准备工作的第一件事是确认本机具备运行该项目的条件：能安装项目所需的运行时与依赖包，能通过命令行启动服务，并且能访问你所选大模型服务的接口。如果所在网络环境访问模型接口受限，需要提前把网络出口处理好，否则生成阶段会直接失败。

获取项目代码与依赖

从项目仓库取得代码后，进入项目目录安装依赖。具体命令以项目仓库当前给出的说明为准，不同版本之间安装方式可能变化。安装完成后先尝试启动一次，确认服务能正常起来、界面能打开，再去做密钥配置。先跑通空壳、再接模型，是排查问题时最省事的顺序。

准备大模型 API 密钥

雾象兼容多种大语言模型，素材中明确提到的是 OpenAI 的 GPT 系列与 Google 的 Gemini。你需要到对应模型服务商处申请 API 密钥，并确认账户具备调用所选模型的权限与额度。密钥拿到后，填入项目中的 credentials.json 文件。这个文件是雾象读取模型凭证的入口，填写时注意：

• 按文件里已有的字段结构填写，不要自行增删键名；
• 只填你实际要用的那一家模型的密钥，用不到的先留空；
• 密钥属于敏感信息，不要提交到公开仓库，也不要贴进截图或分享出去；
• 如果同时配置了多家模型，生成时需要在界面上选定其中一个，避免出现「配了但没选」的情况。

明确你要生成的主题

这一步常被忽略，但直接影响结果。雾象的输入是一个主题或概念，越具体、越有明确讲解目标的题目，越容易得到结构清楚的动画。像「冒泡排序」这种有固定讲解路径的题目，通常比「人工智能」这种宽泛题目更容易出好结果。动手前先想清楚：这段动画要讲给谁看、要讲清哪一个点、大概多长。这些信息在后续调优时都会用到。

操作步骤

第一步：启动雾象并确认模型可用

依赖装好、credentials.json 填好之后启动项目。服务起来后先做一次最小验证：用一个非常短的主题试生成，确认模型接口能通、能返回内容。如果这一步就报错，问题基本集中在密钥无效、额度不足、模型名称不对或网络不通这几类，先解决掉再继续，不要带着错误往下走。

第二步：输入主题

通过雾象的用户界面或命令行工具输入你想要生成动画的主题或概念描述。输入时建议把「讲什么」和「怎么讲」一起写进去，例如不只写「熵增定律」，而是写清希望从哪个角度切入、面向什么基础的观众。系统会解析这段输入，作为后续脚本生成的依据。

第三步：等待自动编排与生成

提交后，雾象会利用大模型完成从文字脚本到动画的整个创作流程：先产出讲解脚本与旁白，再组织视觉元素与动态效果，最后由动画引擎合成完整作品。这一步不需要你手动设计动画细节，但需要等待。生成耗时与主题复杂度、所选模型、输出长度都有关系，主题越大、要求越多，等待越久。生成过程中不要反复提交同一主题，避免产生重复的模型调用消耗。

第四步：用自然语言多轮调优

第一版结果通常不会完全符合预期，这时用语言用户界面（LUI）继续对话调整。可以提的要求包括：某一段旁白讲得太快或太绕、某个概念需要补一个更直观的类比、画面节奏需要放慢、某处视觉元素与讲解内容不匹配等。调整时一次只改一个方面，改完看效果，再决定下一步改什么。一次抛出七八条互相冲突的要求，模型很难同时满足，反而会把已经对的部分改坏。

第五步：导出与使用

满意之后，把生成的动画导出为视频文件或其他格式，用于教学、科普、展示等场景。导出前再完整看一遍成片，重点检查旁白与画面是否对得上、专有名词有没有念错或写错、结尾是否完整。教学用途的动画尤其要核对术语准确性，模型生成的讲解内容需要人工把关。

一个完整示例

下面以「冒泡排序」为主题，走一遍从零到成片的完整流程。这个题目结构清晰、有固定讲解顺序，适合作为第一次跑通的验证题目。

第一步，准备环境。取得项目代码，进入项目目录安装依赖，然后启动服务，确认界面可以正常打开。

# 进入项目目录后安装依赖（具体命令以项目仓库当前说明为准）
# 安装完成后启动服务
# 服务启动后，在浏览器中打开本地地址，确认界面可访问

第二步，配置密钥。编辑项目中的 credentials.json，按文件已有字段填入所选模型服务商的 API 密钥，保存后重启服务让配置生效。

{
  "按文件已有字段填写": "你的 API 密钥"
}

上面只是示意字段位置，实际键名以项目里 credentials.json 的原始结构为准，不要照抄这段占位内容。

第三步，输入主题。在界面或命令行中输入类似这样的描述：

用动画讲解冒泡排序：面向没有编程基础的观众，先说明它为什么叫「冒泡」，再演示一轮比较与交换的过程，最后说明时间复杂度。

第四步，生成并检查。提交后等待系统完成脚本与动画生成。第一版重点看三件事：旁白有没有把「相邻元素两两比较、大的往后换」这个核心讲清；画面里的元素移动是否与旁白同步；结尾有没有交代复杂度。

第五步，多轮调整。假设第一版的问题是交换过程演示太快，可以这样提要求：

把第一轮比较与交换的演示放慢，每一步交换后停顿一下，让观众看清哪两个元素换了位置。

看完第二版，如果发现旁白术语太多，再补一条：

旁白里不要出现「时间复杂度」这个词，改成「数据量变大时，它需要比较的次数会增长得很快」。

第六步，导出。确认旁白、画面、节奏都符合预期后，导出为视频文件，用于课堂讲解或线上课程。

注意事项

模型选择决定成品质量

雾象本身负责编排流程，讲解内容与画面组织由背后的大模型产出。同一个主题换一个模型，脚本结构、旁白措辞、视觉元素的组织方式都可能不同。如果某个主题反复调不出满意结果，换一个模型重试往往比继续在同一个模型上加要求更有效。

密钥与额度是硬约束

生成过程会实际调用模型接口，产生调用消耗。密钥无效、额度用尽、账户无权限调用所选模型，都会让生成中断。多轮调优意味着多次调用，调整次数越多消耗越大，所以调优时要有针对性，不要用反复重生成来代替明确的需求描述。各家模型服务的价格、免费额度与速率限制随时可能调整，具体以服务商官网当前信息为准。

生成内容需要人工核对

动画里的旁白与讲解由模型生成，可能出现术语使用不当、概念表述不严谨、举例不贴切的情况。用于教学、培训等正式场景前，务必逐段核对内容准确性，尤其是数学、物理、计算机等有严格定义的领域。工具能加快出片速度，但不能替代内容把关。

宽泛主题容易得到空泛结果

输入越抽象，模型越容易给出泛泛而谈的脚本。把主题收窄到一个明确的讲解目标，并在输入里写清受众与切入角度，是提升成品质量最直接的办法。如果第一版明显跑偏，与其在结果上反复打补丁，不如回到输入把主题描述重写一遍。

开源项目的版本差异

雾象是开源项目，安装方式、配置字段、界面布局都可能随版本更新而变化。本文给出的流程是稳定的主干，具体命令与字段名请以项目当前版本的实际内容为准。遇到与描述不一致的地方，优先相信项目仓库里的最新说明。