火宝短剧完整部署教程：从剧本到成片的 AI 短剧生成平台

火宝短剧完整部署教程从剧本到成片的 AI 短剧生成平台【免费下载链接】huobao-drama 火宝短剧 - 基于AI的一站式短剧生成平台 《一句话生成完整短剧从剧本到成片全自动化》 Huobao Drama - An AI-Powered End-to-End Short Drama Generator One Sentence to Complete Drama: Fully Automated from Script to Final Video项目地址: https://gitcode.com/gh_mirrors/hu/huobao-drama火宝短剧huobao-drama是一个 AI 短剧自动生成平台把一句话变成一集完整短剧AI 生成剧本、提取角色与场景、拆解分镜、自动产出分镜图和分镜视频最后拼合成片。适合短视频创作者、自媒体人以及想体验 AI 视频生产的开发者。 短剧生产瓶颈火宝短剧解决什么问题做一集短剧通常要写剧本、设计角色、画分镜图、生成视频、再拼接成片一个人手工做下来往往要一周。火宝短剧把这条链路压缩成一条自动流水线你只提供一句主题或一段小说文本剩下环节平台自己跑完。如果你需要持续产出短剧内容、又没有剪辑团队或者不想逐个研究各家模型 API这套工具可以直接用。 完整生产工作流从一句话到成片整个过程是一条输入 → 处理 → 产出的流水线。输入一句话或一部小说你在前端新建剧集填一句主题或粘贴小说文本。script_rewriter Agent 会把输入改写成格式化剧本带集数划分和台词结构。处理四个 Agent 依次提取角色与分镜剧本生成后由三个 Agent 接力extractor 提取并去重角色、场景、道具storyboard_breaker 把剧本拆成分镜序列每条含场景描述与镜头设计prompt_generator 为角色、场景和每个分镜生成图片提示词与视频提示词。你可以在工作台逐条编辑、随时改提示词。产出从角色图到成片视频图片模型OpenAI / Gemini / 火山引擎生成角色立绘与分镜图每个分镜图再由视频模型火山引擎 Seedance 2.0转成视频最后 FFmpeg 把一集的分镜拼合、加字幕得到成片。所有文件落在本地 data 目录由统一素材库管理方便复查和重做。 快速开始本地三步跑起火宝短剧依赖很少FFmpeg 不用装项目用 npm 包内置二进制。软件版本要求用途Node.js20前后端运行环境npm9安装依赖MySQL8.0数据存储Docker 部署时内置git clone https://gitcode.com/gh_mirrors/hu/huobao-drama cd huobao-drama cd backend npm install cd ../frontend npm install然后两个终端分别起前后端cd backend npm run dev # 另一个终端 cd frontend npm run dev验证浏览器打开 http://localhost:3013 看到页面即成功后端 API 在 http://localhost:5679/api/v1前端会自动代理 /api 和 /static。数据库表首次启动自动创建默认账号与库名是 huobao / huobao_drama。启动后到「设置」页配置 AI 服务「火宝快捷配置」粘贴 Key或手动添加模板否则所有 AI 功能不可用。 Docker 一键部署与启动验证不想自备环境就用 Docker Compose一条命令同时拉起应用和 MySQL 8.4含健康检查与启动顺序编排应用等 MySQL 就绪后才启动docker compose up -d --build验证方式浏览器访问 http://localhost:5679 应看到页面再请求一次 http://localhost:5679/api/v1/health返回 200 即服务正常。编排文件见 docker-compose.yml生成文件挂载在 ./dataAgent 技能文件挂载在 ./backend/workspace都持久化。一个高频坑单服务模式自己构建前端时npm run generate之后必须把 .output/public 产物复制到 frontend/dist漏了这一步会出现 API 正常但页面 404。 技术视角一段话看懂架构与技术栈项目是 TypeScript 全栈前端是 Nuxt 3 单页应用纯 CSS 无 UI 框架承担剧集列表、详情、单集工作台和设置页后端是 Hono 服务Drizzle ORM 管理 MySQL 结构启动时自动建表Mastra 跑四个 AI Agent生成的图片视频存在 data/static 本地文件AI 厂商文本/图片/视频全部在数据库里配置由适配器层统一封装调用。端技术栈前端Nuxt 3SPA Vue 3 TypeScript纯 CSS后端Node.js 20、Hono、Drizzle ORM mysql2、Mastra、fluent-ffmpeg、Sharp数据库MySQL 8.0启动自动建表AI 服务文本OpenAI 兼容 / Gemini图片OpenAI / Gemini / 火山引擎视频火山引擎 Seedance 2.0❓ 部署与使用常见问题Q启动后页面顶部提示「尚未配置模型」这是首次使用引导不是错误。进「设置」页「火宝快捷配置」粘贴一个 Key 写入文本/图片/视频三条推荐配置或用手动模板逐厂商添加三类配置齐了横幅自动消失。Q服务器需要安装 FFmpeg 吗不需要。项目通过 ffmpeg-static / ffprobe-static npm 包内置二进制本地和 Docker 都开箱即用。Q容器里要调用宿主机 Ollama 或本地模型怎么配Base URL 用 http://host.docker.internal:11434/v1宿主机 Ollama 需监听 0.0.0.0。Linux 上用 docker run 时再加 --add-hosthost.docker.internal:host-gateway 参数。Q前端连不上后端 API先确认后端在跑、端口是 5679。开发模式的代理配置在 frontend/nuxt.config.ts。 延伸与参与Agent 技能文件是 SKILL.md可在设置页直接在线改不用动源码技能目录持久化在 backend/workspace/skills/。想改源码的话四个 Agent 定义在 backend/src/agents/多厂商 AI 适配器在 backend/src/services/adapters/单集工作台在 frontend/app/views/drama/提交 PR 前先在 backend 跑 npm run typecheck、在 frontend 跑 npm run build 自检。也可以扫码进开源群交流火宝短剧把短剧生产从「一周手工」变成「等待生成」跑一遍你就对这条流水线有体感了。【免费下载链接】huobao-drama 火宝短剧 - 基于AI的一站式短剧生成平台 《一句话生成完整短剧从剧本到成片全自动化》 Huobao Drama - An AI-Powered End-to-End Short Drama Generator One Sentence to Complete Drama: Fully Automated from Script to Final Video项目地址: https://gitcode.com/gh_mirrors/hu/huobao-drama创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考