unreel

这是什么？适合谁？

UNREEL（blendi-remade/unreel）是一个「无限 AI 电视流媒体」实验项目：一个在按下播放之前什么都不存在的流媒体服务。选定一个片名后，showrunner LLM 一次写几个镜头，MiniMax H3 Max Turbo 在 fal.ai 上逐镜头实时渲染。Turbo 渲染速度比片段播放还快，所以下一个镜头总能在当前镜头结束前渲染完成——正是这个事实让「无限频道」成为可能。

内容分两类：14 部原创电影（硬科幻、赛博黑色、西部、民俗恐怖、抢劫、爱情、拳击、黑暗奇幻等）和 8 个脑洞直播频道（Capybara News Network、Goblin Tax Season、Toaster Court、Dad Rock Volcano 等）。每部电影是单次连续长镜头：每个镜头都从上一镜头的最后一帧开始，保持角色、光线和场景一致。封面由 Nano Banana 2 绘制，标题字体渲染进画面。

核心价值：演示「边生成边播放」的实时 AI 视频范式——LLM 写剧本、视频模型逐镜头续帧、播放器无缝切镜，三者在同一条流水线里接力。

适合人群：

• 对生成式视频、实时渲染流水线感兴趣的研究者与工程师
• 想理解「LLM showrunner + 视频模型」架构的前端/全栈开发者
• 探索 AI 原生娱乐形态的产品与创作者

使用前提：Node.js 环境 + 一个 fal.ai 的 API key（视频生成、封面绘制都走 fal）。

准备工作

1. 克隆仓库：git clone https://github.com/blendi-remade/unreel.git
2. 环境：Node.js + npm（Next.js 15 / React 19 / TypeScript）
3. API key：到 fal.ai/dashboard/keys 申请 key，填入 .env.local
4. 成本：构建目录（npm run catalog）一次性约 $0.08/封面 + $0.06/预告；观看时十分钟约不到 $1 + 少量 LLM 调用费
5. 注意：⚠️ 仓库当前未声明开源许可证，源码公开但使用/分发前需自行确认授权

快速上手（3 步）

第一步：安装依赖并配置 key

npm install
cp .env.example .env.local   # 填入你的 fal key（FAL_KEY=...）

第二步：构建目录

npm run catalog   # 绘制 22 张封面 + 22 段预告，约 2 分钟

catalog 会跳过已构建的片名；可用 --force、--only <id>、--covers、--previews 重建部分内容。

第三步：启动并观看

npm run dev

打开本地开发地址，浏览目录、点开一个片名或频道，即可看到边生成边播放的流。

成功判定：选中一个片名后，预告先作为冷开场立即播放，随后镜头逐个实时渲染、无缝衔接，播放器不出现 spinner。

初级用法

浏览片名与频道

启动后进入 browse 页，在原创电影与直播频道之间切换，点选即可播放。

理解流式播放

按下播放后：预渲染预告先作为冷开场 → showrunner 先写 1 个镜头（约 2s），再 4 个、10 个批量写 → 每个镜头从上一镜头的最后一帧渲染（约 2.5s），边播边渲染，缓冲持续增长。

停播

关掉标签页即停止渲染与计费。

高级玩法

添加自己的片名

一切定义在 catalog/titles.mjs：一句 logline、给 showrunner 的前提、附加到每个镜头的视觉风格、封面提示词、预告提示词。mode 设为 story（连续电影）或 chaos（硬切频道），加进一行，跑 npm run catalog -- --only your-id 即可上架。

修改服务品牌

在 lib/brand.ts 里给整个服务改名。

理解渲染节奏

lib/stream.ts 里的常量决定节奏：480P 下 8 秒镜头约 2.5 秒渲染完成，两镜头内缓冲填满；768P 约 5 秒，勉强跟上，所以 480P 是默认。

小技巧

1. 先用 npm run catalog 一次性构建目录，避免边看边等封面
2. FAL_KEY 只放在服务端 .env.local，勿提交到 git
3. 有对白的镜头要逐字引用台词，否则视频模型会「胡言乱语」——showrunner 已把每句台词用引号写出并加声音子句
4. 480P 是节奏最稳的默认档位，768P 帧交接时可能勉强跟上
5. 冷开场用双请求对冲 LLM 延迟（先解析者胜），这是项目应对长尾延迟的实用技巧

常见踩坑

踩坑 1：npm run dev 起不来 / 空白页

• 现象：服务启动但目录为空或渲染失败
• 原因：未先跑 npm run catalog，或 .env.local 里 FAL_KEY 缺失
• 解决：先 cp .env.example .env.local 填 key，再 npm run catalog

踩坑 2：播放卡在冷开场后一直转圈

• 现象：预告播完，后续镜头迟迟不出来
• 原因：fal key 无效 / 余额不足，或 LLM 首调用超时
• 解决：检查 fal dashboard 的 key 与余额；项目用双请求对冲首调用延迟，正常情况不会转圈

踩坑 3：镜头之间角色/场景跳变

• 现象：画面不连续
• 原因：非 story 模式的硬切频道本就有意跳变；story 模式靠「上一镜头最后一帧」续帧，若末帧获取异常会跳变
• 解决：确认所看片名 mode=story；检查同源媒体代理是否正常

踩坑 4：成本超预期

• 现象：跑一会儿账单就涨
• 原因：每个镜头都是一次视频生成调用，直播频道硬切更密集
• 解决：看完即关标签页停止渲染；按 README 估算控制观看时长

踩坑 5：许可证不明确

• 现象：想二次使用 / 分发代码但找不到 LICENSE
• 原因：仓库未声明开源许可证
• 解决：仅作学习研究用途；商用/分发前需联系作者确认授权

常见问题 FAQ

Q: UNREEL 是什么？

A: 一个「无限 AI 电视」实验：LLM 写剧本，MiniMax H3 Max Turbo 边播边逐镜头渲染，形成永不重样的流媒体。

Q: 真的实时生成吗？

A: 是。Turbo 渲染比片段播放快，下一个镜头总在当前镜头结束前渲染好，从而实现连续播放。

Q: 需要什么才能跑起来？

A: Node.js + 一个 fal.ai 的 API key；视频生成、封面绘制都走 fal。

Q: 贵吗？

A: 构建目录一次性约十几美分/片；观看时十分钟约不到 $1，另加少量 LLM 调用费。

Q: 和 Runway、Pika 这类工具的区别？

A: Runway/Pika 是「生成一段视频后导出」的创作工具；UNREEL 是「边生成边播放的无限流」，把生成管线接进了播放器本身。

进阶学习建议

掌握基础后，建议深入：

1. 研究 lib/stream.ts 的客户端状态机（镜头队列、渲染缓冲、末帧链），理解实时生成播放器的核心调度
2. 对比 MiniMax H3 与可灵、Runway Gen-4 在「单镜头生成速度」上的差异，理解为什么只有足够快的模型才能做实时流
3. 探索「LLM showrunner + 视频模型 + 语音字幕」这条 AI 原生内容管线的更多形态（互动剧、个性化直播）

参考链接

• 官方仓库
• MiniMax H3 Max Turbo（fal.ai）
• fal.ai 控制台

最后更新：2026-09-04 · 作者：MagicNetWorld · 基于公开资料整理，关键数据经 GitHub API 独立实测核验，AI 辅助生成