猫影短剧AI驱动的小说转短剧全流程生产平台小说文本自动转换为短剧视频

可以无卡模式运行改项目0.15元每小时按秒计费

镜像简介

猫影短剧是一个 AI 驱动的小说转短剧全流程生产平台。通过本平台，你可以将小说文本自动转换为短剧视频，只需几个简单步骤即可完成从文字到视频的创作。

• 将小说文本自动转换为短剧视频，只需几个简单步骤即可完成从文字到视频的创作
• 项目原地址：https://github.com/Anning01/novelvids
• 本项目选择最低配置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模型的短剧/小说生成平台，支持：

• 📚 小说管理 - 上传、管理小说/剧本
• ✂️ 智能分章 - 使用NLP自动拆分章节
• 👤 角色提取 - AI自动识别提取人物角色
• 🏞️ 场景提取 - AI识别提取场景
• 🎬 分镜生成 - AI生成分镜脚本
• 🎥 视频生成 - 对接第三方API生成视频

---

二、快速开始

2.1 启动平台

# 使用启动脚本 (前端端口7860)
./start_app.sh 7860

# 启动成功后访问:
# - 前端: http://localhost:7860
# - 后端: http://localhost:8000

2.2 平台界面

首次访问 http://localhost:7860 进入前端界面，通过API与后端通信。

---

三、核心功能操作流程

3.1 创建小说

1. 进入小说管理页面

2. 点击新建小说，填写以下信息：

   • 小说名称 (必填)
   • 作者 (可选)
   • 小说内容 (必填，可以是长文本)
   • 封面/描述 (可选)

3. 提交创建

API示例:

curl -X POST http://localhost:8000/api/novel \
  -H "Content-Type: application/json" \
  -d '{"name": "测试小说", "content": "小说内容...", "author": "作者名"}'

---

3.2 智能分章

小说创建后，可以使用NLP智能拆分章节：

1. 打开小说详情
2. 点击"智能分章"按钮
3. 等待AI处理完成

系统会自动识别章节标题和内容，生成多个章节记录。

API示例:

curl -X GET http://localhost:8000/api/novel/{novel_id}/split

---

3.3 提取角色和场景

对单个章节进行资产提取：

1. 进入章节详情
2. 点击"提取资产"
3. 等待AI处理

AI会自动识别并提取：

• 👤 人物角色
• 🏞️ 场景
• 📦 物品

API示例:

curl -X POST http://localhost:8000/api/chapter/extract/{chapter_id}

---

3.4 生成分镜

在提取角色后，可以生成分镜脚本：

1. 进入章节详情
2. 点击"生成分镜"
3. 等待AI生成

AI会分析章节内容，生成详细的分镜列表，包括：

• 镜头描述
• 视觉画面 (Visual Prose)
• 动作指导
• 运镜方式
• 光线氛围
• 声音设计

API示例:

curl -X POST http://localhost:8000/api/scene/generate \
  -H "Content-Type: application/json" \
  -d '{"chapter_id": 1}'

---

3.5 生成参考图

为资产(人物/场景)生成AI参考图：

1. 进入资产库
2. 选择资产
3. 点击"生成参考图"

API示例:

curl -X GET http://localhost:8000/api/asset/reference/{asset_id}

---

3.6 生成视频

对接第三方视频生成API：

方式一: 提交视频生成任务

curl -X POST http://localhost:8000/api/video/generate \
  -H "Content-Type: application/json" \
  -d '{"scene_id": 1, "model_type": 1}'

方式二: 合并章节视频

curl -X POST http://localhost:8000/api/video/merge \
  -H "Content-Type: application/json" \
  -d '{"chapter_id": 1}'

方式三: 查询生成状态

curl -X GET http://localhost:8000/api/video/query/{video_id}

---

四、任务状态查询

所有AI任务都是异步执行的，可以通过返回的任务ID查询状态：

# 查询任务状态
curl -X GET http://localhost:8000/api/ai-task/{task_id}

# 取消任务
curl -X POST http://localhost:8000/api/ai-task/{task_id}/cancel

任务状态说明：

• pending - 待处理
• running - 处理中
• completed - 已完成
• failed - 处理失败
• cancelled - 已取消

---

五、数据管理

5.1 小说管理

操作	说明
创建小说	新建小说/剧本
编辑小说	修改小说信息
删除小说	删除小说(级联删除章节)
智能分章	NLP自动拆分章节

5.2 章节管理

操作	说明
创建章节	手动创建章节
编辑章节	修改章节内容
删除章节	删除章节(级联删除分镜)
提取资产	AI提取人物/场景/物品
生成分镜	AI生成分镜脚本

5.3 分镜管理

操作	说明
创建分镜	手动创建分镜
编辑分镜	修改分镜信息
删除分镜	删除分镜
生成视频	调用第三方API

5.4 资产管理

资产类型：

• 👤 人物 (person)
• 🏞️ 场景 (scene)
• 📦 物品 (item)

每个资产支持：

• 主图 (三视图)
• 2张可选角度图
• AI生成或用户上传

---

六、API接口速查

小说 API

POST   /api/novel              创建小说
GET    /api/novel             获取小说列表
GET    /api/novel/{id}        获取小说详情
PUT    /api/novel/{id}        修改小说
PATCH  /api/novel/{id}       局部修改小说
DELETE /api/novel/{id}       删除小说
GET    /api/novel/{id}/split 智能分章

章节 API

POST   /api/chapter              创建章节
GET    /api/chapter              获取章节列表
GET    /api/chapter/{id}        获取章节详情
PUT    /api/chapter/{id}        修改章节
PATCH  /api/chapter/{id}        局部修改章节
DELETE /api/chapter/{id}        删除章节
POST   /api/chapter/extract/{id} 提取资产

分镜 API

POST   /api/scene/generate    生成分镜
POST   /api/scene/            创建分镜
GET    /api/scene             获取分镜列表
GET    /api/scene/{id}        获取分镜详情
PUT    /api/scene/{id}        修改分镜
PATCH  /api/scene/{id}        局部修改分镜
DELETE /api/scene/{id}        删除分镜

资产 API

POST   /api/asset              创建资产
GET    /api/asset              获取资产列表
GET    /api/asset/{id}        获取资产详情
PUT    /api/asset/{id}        修改资产
PATCH  /api/asset/{id}        局部修改资产
DELETE /api/asset/{id}        删除资产
GET    /api/asset/reference/{id} 生成参考图

视频 API

POST   /api/video/generate    提交视频生成
GET    /api/video/query/{id} 查询视频状态
GET    /api/video/chapter/{chapter_id} 获取章节视频
GET    /api/video/novel/{novel_id}    获取小说视频
POST   /api/video/merge       合并章节视频
GET    /api/video/merge/{chapter_id} 查询合并视频

AI任务 API

GET    /api/ai-task/{task_id}     查询任务状态
POST   /api/ai-task/{task_id}/cancel 取消任务

---

七、常见问题 (FAQ)

Q1: 启动失败，端口被占用？

解决: 关闭占用端口的进程，或使用其他端口启动

# 查看端口占用
lsof -i:7860

# 杀死占用进程
kill -9 <PID>

---

Q2: 前端页面空白或加载失败？

解决: 检查后端是否正常运行，确保API服务正常

# 检查后端日志
cat /tmp/novelvids_backend.log

# 检查前端日志
cat /tmp/novelvids_frontend.log

---

Q3: AI任务一直处于pending状态？

可能原因:

1. 后端服务未启动
2. API配置错误
3. 网络连接问题

解决: 检查服务状��和网络连接

---

Q4: 分镜生成失败？

可能原因:

1. 章节内容为空
2. 未先提取资产(角色/场景)
3. API配置错误

解决: 确保章节有内容，并先执行资产提取

---

Q5: 视频生成失败？

可能原因:

1. 第三方API密钥未配置
2. API调用配额用尽
3. 网络问题

解决: 检查API配置和配额

---

Q6: 如何查看完整的API文档？

访问后端自带的Swagger文档：

http://localhost:8000/docs

---

Q7: 如何重启服务？

# 停止所有服务
pkill -f uvicorn
pkill -f vite

# 重新启动
./start_app.sh 7860

---

Q8: 数据库文件在哪里？

默认位置: ./data/novelvids.db

可以通过环境变量修改:

DATABASE_URL=sqlite://./data/yourdb.db

---

八、工作流总结

1. 上传小说/剧本
       ↓
2. 智能分章 (NLP拆分)
       ↓
3. 选择章节 → 提取资产 (角色/场景/物品)
       ↓
4. 生成分镜脚本
       ↓
5. 生成视频 (可选)
       ↓
6. 完成

---

九、注意事项

1. API密钥: 使用第三方AI服务需要配置有效的API密钥
2. 网络: 确保服务器能访问AI服务商的API端点
3. 存储: 生成的媒体文件保存在 ./media 目录
4. 数据备份: 定期备份SQLite数据库文件

---

最后更新: 2026-04-18