# AI-StoryBook-Creator

**Repository Path**: qurite/AI-StoryBook-Creator

## Basic Information

- **Project Name**: AI-StoryBook-Creator
- **Description**: 基于Coze工作流的AI有声绘本生成器，可以根据故事标题自动生成完整的有声绘本视频，可以替换其他大模型编排工具dify等
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 3
- **Forks**: 1
- **Created**: 2025-08-24
- **Last Updated**: 2025-09-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AI-StoryBook-Creator

基于Coze工作流的AI有声绘本生成器，可以根据故事标题自动生成完整的有声绘本视频。

## 功能特点

- 基于故事标题自动生成完整故事内容
- 为每个故事段落生成配图和朗读音频
- 自动添加字幕和转场效果
- 生成高质量的有声绘本视频

## 安装要求

- Python 3.6+
- FFmpeg（用于视频处理）
- ffmpeg-concat（用于视频转场效果）

### 依赖安装

```bash
pip install requests
```

安装FFmpeg：
- Windows: 下载FFmpeg并添加到系统PATH
- macOS: `brew install ffmpeg`
- Linux: `apt-get install ffmpeg`

安装ffmpeg-concat：
```bash
npm install -g ffmpeg-concat
```

> **注意**：ffmpeg-concat安装可能需要一定门槛，包括Node.js环境配置、路径设置等。详细的安装教程和常见问题解决方案请参考：[ffmpeg-concat 速通指南](https://mp.weixin.qq.com/s/B1AONalzWP2z_7Xu_UBmgw)

## 配置

在使用前，需要在`ai_storybook/config/config.py`中配置以下参数：

- `workflow_id`: Coze工作流ID
- `access_token`: Coze访问令牌
- `base_output_path`: 输出文件保存路径
- `ffmpeg_concat_path`: ffmpeg-concat命令路径

## 使用方法

### 命令行使用

```bash
python -m ai_storybook.cli "故事标题"
```

可选参数：
- `--output-dir`, `-o`: 指定输出目录
- `--workflow-id`, `-w`: 指定Coze工作流ID
- `--access-token`, `-t`: 指定Coze访问令牌

### 代码中使用

```python
from ai_storybook.core.generator import StoryGenerator

# 创建故事生成器
generator = StoryGenerator()

# 生成故事
video_path = generator.generate_story("小马过河")

if video_path:
    print(f"故事生成成功，视频保存在: {video_path}")
else:
    print("故事生成失败")
```

## 项目结构

```
AI-StoryBook-Creator/
├── ai_storybook/            # 主包
│   ├── config/              # 配置模块
│   │   ├── __init__.py
│   │   └── config.py        # 配置文件
│   ├── core/                # 核心模块
│   │   ├── __init__.py
│   │   ├── generator.py     # 故事生成器
│   │   └── processor.py     # 故事处理器
│   ├── utils/               # 工具模块
│   │   ├── __init__.py
│   │   ├── api_utils.py     # API交互工具
│   │   ├── file_utils.py    # 文件处理工具
│   │   └── video_utils.py   # 视频处理工具
│   ├── __init__.py
│   └── cli.py               # 命令行接口
├── examples/                # 示例
│   └── generate_story.py    # 故事生成示例
├── docs/                    # 文档
└── README.md                # 项目说明
```
## Coze工作流配置

本项目依赖于Coze平台的工作流功能。您需要在Coze平台上创建一个工作流，该工作流应该能够：

1. 接收故事标题作为输入
2. 生成完整的故事内容，包括分段落的故事文本
3. 为每个段落生成配图
4. 为每个段落生成朗读音频
5. 输出JSON格式的结果，包含所有必要的图片URL、音频URL和文本内容

详细的工作流配置说明和协议规范请参考 `docs/workflow_protocol.md` 文档，其中包含了完整的API接口定义和数据格式要求。

## 问题与支持

如果您在使用过程中遇到任何问题，或需要进一步的帮助，欢迎扫描下方二维码关注公众号，并通过后台私信联系我们：

![扫码关注公众号](docs/二维码.png)

## 许可证

MIT