一键生成游戏角色精灵动画
基于AI的全自动工作流：从文字描述到精灵动画表
## 📖 项目背景
在游戏开发中，创建角色动画是一个耗时且成本高昂的过程。传统流程需要：
- 🎨 美术设计角色
- 🖌️ 逐帧绘制动画
- ✂️ 手动抠图去背景
- 📐 制作精灵图表
**AI Animation Generator** 将这个复杂的流程简化为一句话描述，利用最新的AI技术自动完成整个工作流。
### 🌟 核心特性
- **文字生成角色** - 使用GPT-4.1优化提示词，gpt-image-1生成高质量角色图
- **智能视频动画** - 豆包AI视频模型生成流畅的角色动画
- **自动背景移除** - 多种AI抠图模型，完美分离角色
- **精灵图生成** - 自动组合帧序列为游戏引擎可用的Sprite Sheet
- **实时预览** - 内置动画播放器，即时查看效果
## 🚀 快速开始
### 环境要求
- Python 3.8+
- macOS / Linux / Windows
- 稳定的网络连接
### 安装步骤
1. **克隆项目**
```bash
git clone https://github.com/yourusername/animation-generator.git
cd animation-generator
```
2. **运行安装脚本**
```bash
chmod +x install.sh
./install.sh
```
3. **配置API密钥**
复制环境变量模板并创建你自己的配置文件：
```bash
cp .env.example .env
```
编辑 `.env` 文件，填入你的API密钥：
```env
OPENAI_API_KEY=your_openai_api_key_here
ARK_API_KEY=your_volcano_engine_api_key_here
```
> ⚠️ **重要**：`.env` 文件包含敏感信息，已被添加到 `.gitignore`，不会被提交到版本控制系统。
> 💡 获取API密钥：
> - OpenAI: https://platform.openai.com/api-keys
> - 火山引擎: https://console.volcengine.com/ark
4. **运行程序**
```bash
./run.sh
```
## 📝 使用方法
### 1. 输入角色描述
```
[1] 请输入角色描述: 一个精灵弓箭手，金发碧眼，森林守护者
```
### 2. 选择生成的角色图
程序会生成4张不同的角色设计供你选择：
```
[2] 请查看生成的4张图片并选择一张:
1) image_1.png
2) image_2.png
3) image_3.png
4) image_4.png
选择 (1-4): 2
```
### 3. 选择动画动作
可以多选，用逗号分隔：
```
[3] 请选择动画动作 (可多选，用逗号分隔):
1) jump
2) run
3) walk
4) wave
5) rotate
6) idle
选择动作: 1,2,6
```
### 4. 选择抠图模型
根据角色风格选择合适的模型：
```
[5] 请选择抠图模型:
1) u2net: 通用模型，适合大多数场景
2) u2netp: 轻量级模型，处理速度快
3) u2net_human_seg: 人物分割模型，适合真人照片
4) isnet-anime: 动漫角色专用模型，高精度分割
```
### 5. 自动处理
程序会自动：
- 🎥 生成选定动作的视频
- 🖼️ 提取视频帧
- ✂️ 移除背景
- 📋 生成精灵图表
## 🎮 示例展示
### 生成的角色设计
