---
title: MANIM_Assistant
canonical_url: "https://www.modelscope.cn/studios/gqy2025/MANIM_Assistant"
md_url: "https://www.modelscope.cn/studios/gqy2025/MANIM_Assistant.md"
repository: gqy2025/MANIM_Assistant
chinese_name: "智绘科普"
last_updated: 2025-12-26
sdk_type: gradio
sdk_version: 5.49.1
downloads: 0
stars: 6
---

# MANIM_Assistant

> MANIM_Assistant - gqy2025 在 ModelScope 创建的在线 Demo。基于Coze AI的智能科普视频生成工具，支持三步骤创作流程，能够快速生成高质量的科普教育视频内容。

gqy2025/MANIM_Assistant 是 ModelScope 魔搭社区上的在线可交互 Demo（创空间），基于 gradio 5.49.1 构建，中文名为「智绘科普」。

- **Repository**: gqy2025/MANIM_Assistant
- **SDK**: gradio
- **SDK version**: 5.49.1
- **Downloads**: 0
- **Stars**: 6
- **Last updated**: 2025-12-26

Source: https://www.modelscope.cn/studios/gqy2025/MANIM_Assistant

---

# 🎬 科普视频生成器

基于Coze AI的智能科普视频生成工具，支持三步骤创作流程，能够快速生成高质量的科普教育视频内容。

## ✨ 功能特性

- **三步骤创作**: 需求输入 → 大纲生成 → 视频生成
- **智能大纲生成**: AI自动分析需求并生成结构化大纲
- **可编辑大纲**: 用户可以自由编辑和调整大纲内容
- **修订模式**: 支持对现有内容进行修订而不是重新生成
- **简洁UI界面**: 步骤向导式设计，操作简单直观
- **实时状态反馈**: 显示生成进度和状态信息
- **视频播放预览**: 内置HTML5视频播放器
- **一键复制下载**: 支持视频链接复制和下载

## 🚀 快速开始

### 环境要求

- Python 3.12+
- 推荐使用 conda 或 venv 创建虚拟环境

### 安装依赖

```bash
pip install -r requirements.txt
```

### 配置环境变量

创建 `.env` 文件并配置以下参数：

```env
coze_api_key=your_coze_api_key_here
workflow_id=your_video_generation_workflow_id_here
OUTLINE_WORKFLOW_ID=your_outline_generation_workflow_id_here
```

### 启动应用

```bash
python app.py
```

应用将在 `http://127.0.0.1:7860` 启动。

## 📁 项目结构

```
MANIM_Assistant/
├── app.py                 # 主应用文件
├── requirements.txt        # 项目依赖
├── .env                   # 环境变量配置
├── .gitignore             # Git忽略规则
├── .python-version        # Python版本指定
└── src/                   # 源代码目录
    ├── __init__.py        # Python包初始化
    └── coze_direct.py     # Coze API调用模块
```

## 🛠️ 技术栈

- **前端**: Gradio 5.23.3
- **后端**: Python
- **AI服务**: Coze API
- **视频处理**: HTML5 Video
- **环境管理**: python-dotenv

## 📖 使用指南

1. **启动应用**: 运行 `python app.py`
2. **步骤1 - 需求输入**:
   - 描述您的科普视频主题和要求
   - 选择目标受众（小学生/中学生/大学生/普通大众/专业人士）
   - 设置期望视频时长（1-10分钟）
   - 点击"生成大纲"
3. **步骤2 - 大纲编辑**:
   - 查看AI生成的结构化大纲
   - 可以自由编辑和调整大纲内容
   - 启用修订模式（可选）
   - 点击"确认大纲"进入下一步
4. **步骤3 - 视频生成**:
   - 预览确认的大纲内容
   - 点击"生成视频"开始制作
   - 查看生成进度和状态
5. **查看结果**: 在右侧查看生成的视频
6. **下载保存**: 使用下载按钮保存视频

## 🎯 工作流程说明

### 📝 步骤1: 需求输入
- **功能**: 收集用户创作需求
- **输入**: 科普主题描述、目标受众、期望时长
- **处理**: AI智能分析和理解用户需求

### ✏️ 步骤2: 大纲生成
- **功能**: 生成可编辑的结构化大纲
- **输入**: 用户需求和修订模式选项
- **输出**: 结构化视频大纲
- **特点**: 支持实时编辑和调整

### 🎬 步骤3: 视频生成
- **功能**: 基于确认的大纲生成科普视频
- **输入**: 确认的大纲内容和修订模式
- **输出**: 高质量科普视频
- **特点**: 基于Manim的动画制作

## ⚡ 输入建议

为了获得更好的生成效果，建议包含以下信息：

- **主题**: 明确要科普的概念或现象
- **受众**: 说明目标观众群体（小学生/中学生/大学生等）
- **时长**: 建议视频时长（1-5分钟）
- **重点**: 希望重点解释的内容
- **风格**: 希望的表达风格（生动有趣/专业严谨等）

## 🔧 故障排除

### 常见问题

1. **API调用失败**
   - 检查 `coze_api_key` 是否正确配置
   - 确认 `workflow_id` 和 `workflow_id2` 是否有效
   - 检查网络连接状态

2. **视频生成失败**
   - 确保输入内容描述清晰
   - 检查Coze服务状态
   - 查看应用日志获取详细错误信息
   - 尝试切换生成模式（标准版 ↔ 极速版）

3. **模式选择问题**
   - 标准版需要配置 `workflow_id`
   - 极速版需要配置 `workflow_id2`
   - 确保两个工作流ID都正确且可用

4. **端口占用**
   - 修改 `app.py` 中的端口号
   - 或使用 `GRADIO_SERVER_PORT` 环境变量指定端口

## 📝 更新日志

### v2.0.0 (2025-11-16)
- ✨ 新增双模式生成功能（标准版 + 极速版）
- 🎛️ 优化UI界面，增加模式选择组件
- 🔧 重构API调用逻辑，支持多工作流切换
- ⚡ 完善错误处理和用户反馈机制
- 📚 更新文档和使用指南

### v1.0.0 (2025-11-14)
- ✨ 实现完整的科普视频生成器UI界面
- 🔧 集成Coze API调用功能
- 🎨 设计简洁的左右分栏布局
- 📱 添加视频播放和下载功能
- ⚡ 优化用户体验和错误处理

## 📄 许可证

本项目采用 [Apache License 2.0](LICENSE) 许可证。

## 🤝 贡献

欢迎提交 Issue 和 Pull Request 来改进这个项目。

#### Clone with HTTP
```bash
git clone https://www.modelscope.cn/studios/gqy2025/MANIM_Assistant.git
```
