# AI 内容生成器 - 使用指南

## 概述

我们已经成功在 MixVideo V2 首页添加了 AI 内容生成器的入口，基于 Text Video Agent API 提供强大的智能内容生成功能。

## 🚀 功能入口

### 1. 首页主要入口
- **位置**: 首页欢迎区域的主要按钮
- **按钮**: "AI 内容生成" (蓝色主按钮)
- **图标**: 魔法棒图标 (Wand2)

### 2. 快速操作入口
- **位置**: 首页快速操作卡片区域
- **卡片**: "AI 内容生成" 
- **描述**: "基于 Text Video Agent API 的智能内容生成"

### 3. 侧边栏导航入口
- **位置**: 左侧导航栏
- **菜单项**: "AI 内容生成"
- **路径**: `/text-video-generator`

## 📱 页面功能

### 主要功能区域

#### 1. **内容生成器** (左侧主要区域)
- **提示词输入**: 支持多行文本输入
- **参数配置**: 
  - 任务类型: Vlog, 茶文化, 人物, 烹饪
  - 长宽比: 9:16, 16:9, 1:1
  - 视频时长: 3秒, 5秒, 10秒
- **参考图片上传**: 可选的参考图片
- **生成选项**: 可选择同时生成视频

#### 2. **信息面板** (右侧)
- **功能介绍**: 详细的功能说明
- **任务类型说明**: 各种任务类型的用途
- **生成统计**: 本次会话的生成统计
- **最近生成**: 显示最新生成的内容
- **使用提示**: 实用的使用建议

### 操作按钮

#### 主要操作
- **生成内容**: 端到端的完整生成流程
- **仅生成图片**: 只生成图片内容
- **基于图片生成视频**: 使用已生成的图片创建视频
- **取消**: 取消当前正在进行的操作
- **重置**: 清除所有输入和结果

#### 状态显示
- **实时进度**: 显示当前处理步骤和进度百分比
- **错误提示**: 友好的错误信息显示
- **连接状态**: API 连接状态指示

## 🔧 技术特性

### API 集成
- **Text Video Agent API**: 完整的 API 封装
- **图片生成**: 基于 Midjourney 的高质量图片生成
- **视频生成**: 基于极梦的视频生成功能
- **文件上传**: 支持参考图片上传
- **图片分析**: AI 图片内容描述

### React Hook
- **useTextVideoAgent**: 状态管理和 API 调用
- **useTaskPolling**: 任务状态轮询
- **错误处理**: 完善的错误处理机制
- **进度跟踪**: 实时进度更新

### 用户体验
- **响应式设计**: 适配不同屏幕尺寸
- **实时反馈**: 即时的状态更新和进度显示
- **直观界面**: 清晰的视觉层次和交互反馈
- **错误友好**: 完善的错误处理和恢复机制

## 📋 使用流程

### 基础使用
1. **进入页面**: 通过首页任意入口进入 AI 内容生成器
2. **输入提示词**: 在文本框中描述想要生成的内容
3. **配置参数**: 选择任务类型、长宽比、视频时长等
4. **开始生成**: 点击"生成内容"按钮
5. **查看结果**: 在结果区域查看生成的图片和视频

### 高级使用
1. **上传参考图片**: 提供参考图片以提高生成质量
2. **分步生成**: 先生成图片，再基于图片生成视频
3. **批量生成**: 使用不同参数生成多个版本
4. **结果管理**: 下载和保存生成的内容

## 🎯 使用示例

### 示例1: 生成产品展示视频
```
提示词: "一个现代简约的咖啡杯，温暖的灯光，木质桌面，专业产品摄影"
任务类型: Vlog
长宽比: 9:16
视频时长: 5秒
```

### 示例2: 生成人物肖像
```
提示词: "一位优雅的女性，微笑着品茶，自然光线，温馨的下午时光"
任务类型: 人物
长宽比: 9:16
参考图片: 上传人物参考照片
```

### 示例3: 生成烹饪场景
```
提示词: "专业厨师在制作精美料理，动作流畅，厨房环境，美食摄影"
任务类型: 烹饪
长宽比: 16:9
视频时长: 10秒
```

## 🔍 功能亮点

### 1. **智能化生成**
- 基于先进的 AI 模型
- 支持多种内容类型
- 高质量的输出结果

### 2. **用户友好**
- 直观的操作界面
- 实时的进度反馈
- 详细的使用指导

### 3. **灵活配置**
- 多种参数选项
- 自定义生成设置
- 支持参考图片

### 4. **完整流程**
- 端到端的生成流程
- 从图片到视频的完整链路
- 结果预览和下载

## 🚨 注意事项

### 使用限制
- 生成过程可能需要 1-3 分钟
- 需要稳定的网络连接
- API 可能有使用配额限制

### 最佳实践
- 提示词要具体详细
- 合理选择参数配置
- 可以多次尝试不同设置
- 及时保存满意的结果

### 故障排除
- 如果生成失败，可以尝试重新生成
- 检查网络连接状态
- 简化提示词内容
- 联系技术支持

## 🔗 相关链接

- **API 文档**: https://bowongai-dev--text-video-agent-fastapi-app.modal.run/docs
- **项目仓库**: 本地项目目录
- **技术支持**: 开发团队

## 📈 未来规划

### 短期计划
- [ ] 添加更多任务类型
- [ ] 优化生成速度
- [ ] 增加批量处理功能
- [ ] 支持更多文件格式

### 长期规划
- [ ] 集成更多 AI 模型
- [ ] 添加风格迁移功能
- [ ] 支持实时预览
- [ ] 云端存储集成

---

通过这个 AI 内容生成器，用户可以轻松创建高质量的图片和视频内容，大大提升创作效率和内容质量。