一句话生成完整短剧火宝短剧 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 短剧生成平台输入一句话即可自动完成剧本、分镜、画面生成到视频合成的全流程。适合没有影视制作背景、希望快速把想法变成短剧成片的内容创作者、短视频博主和个人开发者。它解决什么问题把一句话推进到成片假设你已经写好了剧情梗概接下来要面对的是选角、搭景、拍摄、剪辑这一整套环节每一环都依赖人手和预算。火宝短剧把这条链路拆成可以由模型完成的工序你只需要在界面里给出创意系统会依次推进剧本改写 → 角色/场景提取 → 分镜拆解 → 角色图与场景图生成 → 分镜视频生成 → FFmpeg 合成导出。内部由 4 个 Mastra Agent 分工协作定义在backend/src/agents/目录script_rewriter把小说或梗概改写成格式化剧本extractor提取角色、场景、道具信息并去重storyboard_breaker把剧本拆成可拍摄的分镜序列prompt_generator生成图片与分镜视频的提示词Agent 的提示词和技能放在backend/workspace/skills/支持在设置页在线编辑不用改代码就能调整它们的输出风格。从零跑起来环境检查与前后端启动先确认环境。Node.js 需要 20 版本MySQL 8.0 仅在本地源码部署时需要Docker 部署已内置FFmpeg 不用单独安装项目通过ffmpeg-static/ffprobe-static自带二进制本地与容器环境开箱即用。node --version git clone https://gitcode.com/gh_mirrors/hu/huobao-drama cd huobao-drama克隆后分别在两个目录安装依赖然后各自启动# 终端 1后端 cd backend npm install npm run dev # 终端 2前端 cd frontend npm install npm run dev启动完成后前端在http://localhost:3013后端 API 在http://localhost:5679/api/v1前端会自动把/api与/static代理到后端。数据库连接通过环境变量配置DATABASE_URL或MYSQL_*分项均有默认值表结构在首次启动时自动创建无需手动建表。如果不想本地装 Node 与 MySQL也可以用 Docker Compose 一条命令拉起应用和 MySQL 8.4docker compose up -d --build访问http://localhost:5679即可健康检查与启动顺序已编排好。配置 API 密钥provider 怎么切换、本地模型怎么接入当前版本不再依赖本地配置文件AI 服务的 API Key、Base URL 和模型名称统一在 Web 界面「设置」页填写并写入数据库环境变量只负责数据库地址和服务端口。仓库中的configs/config.example.yaml是早期示例仅作参照。首次进入页面顶部会有横幅引导。完成配置有两条路快捷配置粘贴一个 Huobao API Key一键写入文本、图片、视频三条推荐配置手动模板按厂商逐条添加每条配置都支持连通性测试。provider 的切换就是在这里换厂商能力可选 provider文本OpenAI 兼容接口、Gemini图片openai、gemini、volcengine视频volcengineSeedance 2.0 标准 / Fast / Mini、minimax各能力的 Adapter 实现集中在backend/src/services/adapters/按 provider 名称路由到对应厂商的接口封装。本地模型接入Ollama想省 API 费用时可以把 Base URL 指向本地服务。宿主机启动 Ollama 时需监听所有网卡export OLLAMA_HOST0.0.0.0:11434 ollama serve然后在「设置 → AI 服务配置」中填写Provider 选openai走兼容接口Base URL 填http://localhost:11434/v1源码部署或http://host.docker.internal:11434/v1容器部署Model 填qwen2.5:latest等已拉取的模型名。Linux 下用docker run时需追加--add-hosthost.docker.internal:host-gateway。让出片更快更稳任务并行与模型选择并行执行角色图、场景图与分镜视频任务可以分批并行发起不需要等上一个任务结束再提交下一个任务列表抽屉里能分别跟踪进度。素材缓存与缩略图生成的图片会自动产出 400px 缩略图*_thumb.webp视频会抽取海报帧*_poster.jpg列表页只加载小图点开才加载原文件浏览大量分镜时明显更快。按环节选模型剧本改写建议用长文本推理能力强的模型输出更稳的分镜结构图片环节可以先用同一提示词在不同 provider 之间对比细节表现再固定下来视频环节草稿阶段选 Seedance 2.0 Fast 档位成片阶段再切标准档兼顾速度和画面质量当前默认即 Fast 档。问题排查四个高频问题现象页面顶部一直提示「尚未配置模型」。原因文本、图片、视频三类配置中还有未启用的。处理进入「设置」页补齐对应配置横幅会自动消失。现象前端页面正常但接口请求全部失败。原因后端未启动或端口与代理目标不一致。处理确认 5679 端口的后端进程在跑开发模式下代理配置见frontend/nuxt.config.ts。现象容器内配置了 Ollama 却连不上。原因Ollama 默认只监听 127.0.0.1容器访问不到。处理按上文设置OLLAMA_HOST0.0.0.0:11434容器侧使用host.docker.internal地址。现象数据库连接成功但表不存在。原因首次初始化未完成或被中断。处理查看后端日志确认建表重试结果必要时重启一次触发重新初始化。成片导出后是标准视频文件竖屏横屏均可直接使用适合直接上传到各短视频平台。火宝短剧把「一句话到成片」的链路做成了可配置、可替换模型的工作流你可以先用默认配置跑通一集再按环节逐步替换更合适的模型。项目说明README.mdAI 服务与 Adapter 源码backend/src/services/早期配置示例configs/config.example.yaml【免费下载链接】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），仅供参考