火宝AI短视频创作系统可以无卡模型运行该项目使用前阅读使用说明

本项目选择最低配置P40或者无卡模型运行即可

镜像使用视频教程

使用前看看视频教程【新手非常必要】：

https://www.bilibili.com/video/BV1EwFzzsEsQ/

bug反馈可以加入科哥专属群交流➕ 广告勿进！​

​

【插入一个小广告 给需要做ai漫画ai短剧的朋友另一个选择】：

【好消息】sora在线生成注册免费体验2次！欢迎免费测试使用！ 1.api中转站【推荐】，全球最卷，有些比官网便宜90+%： https://ai.kegeai.top/register?aff=78Gs

• 工作流有sora，veo3，grok3等ai视频生成，谷歌香蕉修图等等。

• 注册帮助： https://kege-aigc.feishu.cn/docx/Gr5wddbYwogvkSxYfdxc7ou1nFb?from=from_copylink

• 技术微信：312088415

---

项目运行截图：

---

火宝短剧 - 用户使用手册

一、系统概述

火宝短剧是一款 AI 驱动的短剧制作工作台，帮助用户从剧本到成片完成短剧创作。

核心功能

功能	说明
项目管理	创建、管理多个短剧项目
剧集管理	每项目支持多集，每集独立配置
剧本改写	AI 将小说/原文改编为短剧剧本格式
角色提取	从剧本自动提取角色信息
场景提取	从剧本自动提取场景信息
分镜拆解	AI 自动将剧本拆解为分镜方案
音色分配	为角色选择匹配的 AI 配音
图片生成	生成角色图、场景图、镜头图
视频生成	生成镜头视频
音频生成	生成旁白、对白语音
视频合成	将视频、图片、音频合成为成片

---

二、快速启动

启动服务

cd /root/huobao-drama
./start_app.sh 7860

访问地址

• 前端: http://服务器IP:7860
• 后端 API: http://服务器IP:5679

停止服务

pkill -f "tsx watch"
pkill -f "nuxt dev"

---

三、操作流程

流程一：创建项目

1. 打开前端页面，点击「新建项目」
2. 填写项目名称（如：《都市情感剧》）
3. 选择计划集数（默认1集）
4. 选择视觉风格（realistic/anime/ghibli/cinematic/comic/watercolor）
5. 点击「创建项目」

流程二：添加剧集

1. 进入项目详情页
2. 点击「添加集」
3. 填写标题（可选，默认按集数命名）
4. 选择图片配置（锁定图片生成服务）
5. 选择视频配置（锁定视频生成服务）
6. 选择音频配置（锁定音频生成服务）
7. 点击「创建并锁定配置」

注意：创建后生成配置将锁定，不可更改，请在创建时选择正确的服务。

流程三：编写剧本

1. 进入剧集工作台
2. 在「剧本」模块点击「导入剧本」或直接输入原始内容
3. 点击「AI 改写」，等待 AI 将原文改写为短剧剧本格式
4. 检查并修改剧本内容

剧本格式说明：

• 场景头：## S编号 | 内景/外景 · 地点 | 时间段
• 动作描写：自然段落
• 对白：角色名：（状态/表情）台词内容

流程四：提取角色场景

1. 剧本完成后，点击「角色提取」
2. 等待 AI 分析剧本，提取角色
3. 在「角色」模块查看提取的角色列表
4. 补充角色外貌特征描述

流程五：拆解分镜

1. 剧本和角色场景准备好后，点击「拆解分镜」
2. 等待 AI 将剧本拆解为多个镜头
3. 在「分镜」模块查看所有镜头
4. 完善每个镜头的：景别、机位、运镜、动作、对白、提示词等

每个镜头建议 10-15 秒

流程六：生成素材

1. 生成角色图：在「角色」模块点击角色对应的生成按钮
2. 生成场景图：在「场景」模块点击场景对应的生成按钮
3. 生成分镜图：在「分镜」模块点击镜头对应的生成按钮
4. 生成视频：在「分镜」模块点击视频生成按钮
5. 生成音频：在「分镜」模块点击音频生成按钮（旁白/对白）

流程七：合成成片

1. 所有素材准备完成后，点击「合成」
2. 等待系统将视频、图片、音频合成为完整短片
3. 导出或下载最终成片

---

四、页面功能说明

4.1 项目列表页 (/)

区域	功能
顶部	显示项目数量
新建按钮	创建新项目
卡片	显示每个项目：集数、角色数、场景数、进度
点击卡片	进入项目详情页
删除按钮	删除项目

4.2 剧集列表页 (/drama/:id)

区域	功能
返回按钮	返回项目列表
顶部信息	显示项目名称、风格、角色数、场景数
添加集按钮	创建新集
集卡片	显示每集：集号、标题、剧本状态、时长
点击集卡片	进入剧集工作台

4.3 工作台页 (/drama/:id/episode/:number)

工作台包含以下模块：

模块	功能
剧本	编写/导入/AI改写剧本
角色	查看/编辑角色，生成角色图
场景	查看/编辑场景，生成场景图
分镜	查看/编辑镜头，生成图片/视频
素材	查看已生成的素材文件
合成	将素材合成为成片

4.4 设置页 (/settings)

用于配置 AI 服务商和 Agent 参数：

标签页	功能
AI 服务	添加/管理文本、图片、视频、音频服务配置
Agent 配置	调整 Agent 模型、提示词、参数
Skills	编写 Agent 技能提示词文件

添加 AI 服务配置

1. 进入「AI 服务」标签页
2. 选择服务类型（文本/图片/视频/音频）
3. 点击「添加」
4. 选择服务商模板或手动填写：
   • 服务商（provider）
   • API Key
   • Base URL
   • 模型名称
5. 开启「测试」验证配置
6. 保存

火宝一键配置

在设置页点击「火宝一键配置」，填写 Huobao API Key，系统自动配置推荐的文本、图片、视频、音频服务。

---

五、功能详解

5.1 AI 改写 (script_rewriter)

将小说或原始内容改写为专业的短剧剧本格式。

输入：小说原文或原始内容 输出：格式化短剧剧本

5.2 角色场景提取 (extractor)

从剧本中自动提取出现的角色和场景，避免重复创建。

智能去重：

• 角色：按名字精确匹配，同名保留现有
• 场景：按「地点+时间段」精确匹配

5.3 分镜拆解 (storyboard_breaker)

将剧本拆解为分镜序列，每个镜头 10-15 秒。

分镜字段：

• title：镜头标题
• shot_type：景别（全景/中景/近景/特写）
• angle：机位角度（平视/仰视/俯视/侧拍）
• movement：运镜（固定/推镜/拉镜/摇镜/跟拍）
• location：地点（从场景列表选择）
• time：时间段（从场景列表选择）
• character_ids：涉及的角色
• action：角色动作与表演
• dialogue：对白或旁白
• description：镜头概述
• image_prompt：图片生成提示词
• video_prompt：视频生成提示词

5.4 音色分配 (voice_assigner)

根据角色的性别、性格、年龄为角色选择合适的 AI 配音。

5.5 图片提示词生成 (grid_prompt_generator)

生成高质量的英文图像提示词，用于：

• 角色图片
• 场景图片
• 宫格图（多格组合图）

---

六、常见问题 FAQ

Q1: 启动脚本报错 "lsof: command not found"

A: 安装 lsof：

apt-get install -y lsof

Q2: 前端无法从外网访问

A: 确保启动时加 --host 0.0.0.0 参数，或检查防火墙：

iptables -L INPUT

Q3: AI 服务配置测试失败

A: 检查：

1. API Key 是否正确
2. Base URL 是否能访问
3. 模型名称是否匹配服务商

Q4: 视频生成失败

A:

1. 检查视频服务配置是否启用
2. 确认已生成图片（或使用首尾帧模式）
3. 查看错误日志定位具体问题

Q5: 集的配置创建后可以修改吗？

A: 不可以。创建集时锁定的图片/视频/音频配置创建后无法修改，如需更换服务只能删除集重新创建。

Q6: 工作台数据在哪里？

A: 项目使用 SQLite 数据���，位于 data/drama_generator.db。

Q7: 如何查看日志？

A:

# 前端日志
tail -f /tmp/frontend.log

# 后端日志
tail -f /tmp/backend.log

---

七、服务配置推荐

Huobao 推荐配置（一键配置）

在设置页使用「火宝一键配置」，输入 Huobao API Key 即可自动配置：

• 文本：ChatFire (gemini-3-pro-preview)
• 图片：Gemini (gemini-3-pro-image-preview)
• 视频：火山引擎 (doubao-seedance-1-5-pro)
• 音频：MiniMax (speech-2.8-hd)

手动配置模板

服务类型	服务商	推荐 Base URL	模型
文本	ChatFire	https://api.chatfire.site	gemini-3-pro-preview
文本	OpenRouter	https://openrouter.ai/api	google/gemini-3-flash-preview
文本	OpenAI	https://api.openai.com	gpt-4.1-mini
图片	Gemini	https://api.chatfire.site	gemini-3-pro-image-preview
图片	火山引擎	https://ark.cn-beijing.volces.com	doubao-seedream-4-0
视频	火山引擎	https://api.chatfire.site/volcengine	doubao-seedance-1-5-pro
视频	Vidu	https://api.vidu.com	viduq3-turbo
视频	阿里	https://dashscope.aliyuncs.com	wan2.6-i2v-flash
音频	MiniMax	https://api.chatfire.site/minimax	speech-2.8-hd

---

八、端口说明

端口	服务	说明
7860	前端	Web 界面（可自定义）
5679	后端	API 服务

---

如有其他问题，请查看后端日志或检查 AI 服务配置。