# AIGen 用户手册

## 目录

- [系统概述](#系统概述)
- [快速开始](#快速开始)
- [功能详解](#功能详解)
  - [视频生成](#视频生成)
  - [图片生成](#图片生成)
  - [任务管理](#任务管理)
  - [设置与配置](#设置与配置)
- [详细使用教程](#详细使用教程)
- [界面导航](#界面导航)
- [常见问题](#常见问题)
- [技术规格](#技术规格)
- [最佳实践](#最佳实践)

<!--启动命令-->
source .venv/bin/activate
gunicorn -k uvicorn.workers.UvicornWorker app.main:app -b 0.0.0.0:8080 --workers 2
---

## 系统概述

**AIGen** 是一个强大的 AI 驱动的视频和图像生成平台，提供了简单易用的 Web 界面，让您能够通过文字描述轻松创建高质量的视频和图片。

### 核心特性

#### 🎬 视频生成
- **多种模型支持**：Sora-2（基础）、Sora Video2（新一代）、方向特化模型（横屏/竖屏15秒优化）
- **灵活的视频参数**：自定义画面比例（横屏/竖屏/方形）、时长（10-20秒）
- **参考图支持**：上传图片作为视频生成的参考
- **角色视频**：支持角色视频链接和时间戳控制
- **水印选项**：可选择有无水印的高清输出

#### 🖼️ 图片生成
- **Gemini 模型**：使用最新的 Gemini 3 Pro Image 模型
- **多种宽高比**：1:1、16:9、9:16、2:3、3:2、3:4、4:3、4:5、5:4、21:9
- **多种尺寸**：1K、2K（推荐）、4K
- **图片编辑**：上传参考图进行 AI 辅助编辑

#### 📊 任务管理
- **实时状态追踪**：自动轮询任务状态，显示生成进度
- **任务历史**：查看所有历史任务记录
- **智能分类**：区分视频和图片任务
- **隐私保护**：每个用户只能看到自己的任务

#### 🌐 用户体验
- **中英双语**：完整的中英文界面支持
- **深色主题**：舒适的深色工作台界面
- **响应式设计**：完美适配桌面和移动设备
- **实时预览**：在线播放视频、查看图片

---

## 快速开始

### 第一步：访问平台

1. 打开浏览器，访问 AIGen 平台网址
2. 您将看到欢迎页面，展示平台的核心功能

> **提示**：AIGen 支持两种使用模式：
> - **游客模式**：无需注册即可使用，但任务数据在服务器重启后会丢失
> - **注册用户**：注册或登录账号后，任务数据会永久保存
> 
> 建议注册账号以获得更好的使用体验。

### 第二步：配置令牌

在开始生成之前，您需要配置令牌：

1. 点击导航栏右上角的**"设置"**按钮
2. 在弹出的对话框中，输入您的 **AI Gen 创建的令牌**
3. 点击**"保存"**按钮
4. 令牌将安全地保存在您的浏览器 Cookie 中（有效期 90 天）

> **提示**：如果您没有令牌，请联系管理员获取。令牌用于调用 AI 生成服务。

### 第三步：开始创作

1. 点击**"快速体验"**或导航到**"工作台"**页面
2. 选择生成模式：**视频生成** 或 **图片生成**
3. 输入您的创意描述
4. 调整参数（可选）
5. 点击**"生成"**按钮
6. 等待 AI 完成创作

---

## 功能详解

### 视频生成

#### 访问方式
- 导航栏点击**"工作台"**
- 选择**"视频生成"**模式（默认）

#### 主要参数

##### 1. 提示词（必填）
描述您想要生成的视频内容。

**示例**：
```
一只蝴蝶在五彩缤纷的花园里飞舞，阳光透过树叶洒下斑驳光影
A butterfly dancing in a colorful garden, sunlight filtering through leaves creating dappled shadows
```

**提示词技巧**：
- **具体化**：详细描述场景、动作、氛围
- **分类明确**：说明主体、环境、光线、动作
- **风格描述**：可以添加"电影级画质"、"写实风格"等修饰词
- **动作描述**：视频需要描述动态元素（"飞舞"、"流动"、"旋转"等）

##### 2. 模型选择

**基础模型**：
- **sora-2**：标准版本，适合一般使用

**新一代模型**：
- **sora_video2**：新一代基础视频模型，性能提升

**方向特化模型**（专门优化，推荐）：
- **sora-2-landscape-15s**：横屏15秒专用，适合常规视频内容
- **sora-2-portrait-15s**：竖屏15秒专用，适合社交媒体短视频

> 💡 **提示**：方向特化模型针对特定画面比例和时长进行了优化，可获得更好的生成效果。

##### 3. 画面比例
- **16:9 (1280x720)**：横屏，适合普通视频
- **9:16 (720x1280)**：竖屏，适合移动端短视频
- **1:1 (1024x1024)**：方形，适合社交媒体
- **HD 16:9 (1792x1024)**：高清横屏
- **HD 9:16 (1024x1792)**：高清竖屏
- **自动**：由系统自动选择最佳比例

##### 4. 视频时长
- **10 秒**：快速生成，节省额度
- **15 秒**：标准时长
- **20 秒**：更长的内容展示
- **自动**：由系统决定合适的时长

##### 5. 参考图（可选）
上传一张图片，AI 将参考该图片的风格、构图或内容生成视频。

**支持格式**：JPG、PNG、GIF 等常见图片格式  
**文件大小限制**：最大 20MB（可在管理页面调整）

**上传方式**：
- 点击"选择文件"按钮
- 或直接拖拽图片到上传区域

##### 6. 水印选项
- **无水印（高清）**：推荐选择，生成高清无水印视频
- **带水印**：视频会包含平台水印

##### 7. 角色视频（高级功能，可选）

**角色视频链接**：提供一个角色视频的 URL  
**角色时间戳**：指定角色出现的时间范围（格式：`起始秒,结束秒`，例如 `1,3`）

⚠️ **重要提示**：
- 视频中**不能出现真人**，否则会导致生成失败
- 时间差值必须在 **1-3 秒之间**
- 仅用于动画、卡通等虚拟角色

#### 快速提示词功能

工作台提供了丰富的提示词库，帮助您快速开始：

**分类标签**（点击自动填充该类别的随机提示词）：
- 🌿 **自然风光**：山水、海洋、天空、森林等自然场景
- 🏙️ **城市景观**：都市、建筑、街道、夜景等
- ✨ **奇幻魔法**：魔法、幻想、科幻、超现实场景
- 🏃 **动作运动**：运动、极限、赛车、冲浪等动态场景
- 🍜 **美食特写**：食物、烹饪、餐饮等

**随机提示词按钮**：点击"随机提示词"按钮，系统会从所有类别中随机选择一个优质提示词。

---

### 图片生成

#### 访问方式
- 导航栏点击**"工作台"**
- 点击**"图片生成"**模式切换按钮

#### 主要参数

##### 1. 提示词（必填）
描述您想要生成的图片内容和风格。

**示例**：
```
赛博朋克风格的猫咪，戴着发光的VR眼镜，霓虹色调
Cyberpunk style cat wearing glowing VR goggles, neon color palette
```

**图片提示词技巧**：
- **风格描述**：明确说明艺术风格（水彩、油画、像素艺术、3D 渲染等）
- **颜色氛围**：指定色调（暖色调、冷色调、霓虹色、黑白等）
- **细节描述**：描述质感、光线、构图等细节
- **参考风格**：可以参考特定艺术家或艺术流派（如"梵高风格"、"宫崎骏风格"）

##### 2. 模型选择
- **Gemini 3 Pro Image Preview**：预览版，功能最新（推荐）
- **Gemini 3 Pro Image**：正式版，稳定性更好

##### 3. 宽高比
选择图片的长宽比例：
- **16:9**：横屏，适合桌面壁纸、横版海报
- **1:1**：方形，适合社交媒体头像、方形海报
- **9:16**：竖屏，适合手机壁纸、竖版海报
- **2:3、3:2、3:4、4:3、4:5、5:4**：其他常用比例
- **21:9**：超宽屏，适合电影画幅

##### 4. 图片尺寸
- **1K**：较小尺寸，生成速度快
- **2K**：标准尺寸（推荐），平衡质量和速度
- **4K**：高分辨率，生成时间较长，消耗更多额度

##### 5. 参考图（可选，用于编辑）
上传一张图片，AI 将根据您的提示词编辑该图片。

**使用场景**：
- 修改图片风格（例如：将照片变成油画风格）
- 添加元素（例如：在图片中添加一只猫）
- 改变氛围（例如：将白天场景变成夜晚）
- 调整构图或色彩

**提示词示例**：
```
在这张图片中添加一只猫，保持原有风格
Convert this photo to watercolor painting style
```

#### 风格标签快速选择

图片生成模式提供了风格标签，点击可快速生成该风格的图片：
- 🤖 **赛博朋克**
- 🎨 **艺术风格**
- 🎮 **像素艺术**
- 🌸 **日式动漫**
- 🔮 **魔法奇幻**
- 🚀 **科幻未来**

---

### 任务管理

#### 最近生成记录

在工作台页面底部，您可以看到**"最近生成记录"**区域，显示最近 20 个任务。

**任务卡片信息**：
- **提示词**：生成时使用的描述
- **状态徽章**：
  - 🔵 **排队中**：任务已提交，等待处理
  - 🟡 **生成中**：AI 正在生成，显示进度百分比
  - 🟢 **完成**：生成成功，可以查看和下载
  - 🔴 **失败**：生成失败，显示错误原因
- **进度条**：实时显示生成进度（0-100%）
- **预览区域**：
  - 视频：显示视频第一帧，点击可全屏播放
  - 图片：显示缩略图，点击可放大查看
- **创建时间**：任务创建的时间

**操作按钮**：
- **查看详情**：跳转到任务详情页，查看完整信息和日志
- **下载**：下载生成的视频或图片（仅完成的任务显示）

**自动刷新**：
- 有未完成任务时，每 **10 秒**自动刷新一次
- 所有任务完成后，每 **15 秒**刷新一次（最多持续 2 分钟）以捕获新提交的任务
- 2 分钟后自动停止刷新，节省资源
- 手动点击**"刷新"**按钮可立即更新
- **任务详情页**：状态每 **2 秒**刷新，日志每 **4 秒**刷新

#### 任务列表页

访问方式：导航栏点击**"任务"**

**功能**：
- 查看所有历史任务（按时间倒序排列）
- 显示任务的完整信息：模型、提示词、状态、进度、创建时间
- 点击任务卡片可查看详情
- 快速查找：输入任务 ID 快速定位

#### 任务详情页

点击任务卡片的**"查看详情"**或**"任务详情"**按钮进入。

**页面内容**：

##### 1. 任务基本信息
- **任务 ID**：唯一标识符
- **模型**：使用的 AI 模型
- **提示词**：完整的输入描述
- **创建时间**：任务提交时间

##### 2. 实时状态面板
- **当前状态**：实时显示任务状态（排队中/生成中/完成/失败）
- **进度百分比**：生成进度（0-100%）
- **已用时间**：从创建到当前的耗时
- **预计剩余时间**（生成中）：根据进度估算的剩余时间
- **自动轮询**：每 2 秒自动更新，任务完成后停止

##### 3. 任务日志
显示任务的所有状态变更记录：
- **提交**：任务首次提交
- **状态变更**：排队中 → 生成中 → 完成/失败
- **时间戳**：每次变更的时间（相对时间，如"30秒前"、"2分钟前"）
- **去重显示**：连续相同的日志会合并显示，并显示出现次数

##### 4. 内容查看（仅完成的任务）
- **在线预览**：直接在浏览器中播放视频或查看图片
- **全屏播放**：视频支持全屏播放和进度控制
- **下载按钮**：下载生成的文件到本地

##### 5. 错误信息（仅失败的任务）
显示失败原因和友好的错误提示：
- **额度不足**：令牌额度已用尽，请联系管理员充值
- **令牌不可用**：令牌状态异常，请联系管理员
- **内容违规**：生成内容违反平台规则（如真人出现在角色视频中）
- **网络错误**：连接上游服务失败，请稍后重试
- **其他错误**：显示具体的错误消息

##### 6. 返回导航
- 智能返回按钮：根据来源页面（工作台/任务列表）自动跳转回相应页面

---

### 设置与配置

#### 账户模式

**游客模式**：
- 无需注册即可使用平台的所有功能
- 任务数据存储在浏览器缓存和服务器内存中
- **限制**：
  - 服务器重启后任务数据会丢失
  - 任务仅在当前浏览器会话中可见
  - 更换浏览器或设备后无法查看之前的任务
- **适用场景**：快速体验、临时使用、测试功能

**注册用户模式**：
- 注册或登录账号后，任务数据会永久保存到数据库
- 支持跨设备访问（同一账号在不同设备上可查看所有任务）
- 服务器重启后任务数据不会丢失
- **建议**：长期使用或需要保存任务历史的用户应注册账号

**注册/登录**：
- 访问首页或导航栏，点击**"注册"**或**"登录"**按钮
- 注册需要提供用户名和密码
- 登录后，所有新创建的任务会自动关联到您的账号

#### 令牌管理

**访问方式**：导航栏点击**"设置"**

**令牌配置**：
1. 在弹出的设置对话框中输入您的 **AI Gen 创建的令牌**
2. 点击**"保存"**
3. 令牌将以以下方式存储：
   - **浏览器 LocalStorage**：方便下次自动填充
   - **HttpOnly Cookie**：安全地发送到服务器，有效期 90 天

**令牌优先级**（从高到低）：
1. 生成表单中手动输入的令牌（开发/测试使用）
2. Cookie 中保存的令牌（正常使用）
3. 服务器环境变量配置的令牌（管理员配置）

**令牌安全性**：
- 令牌存储在 **HttpOnly Cookie** 中，JavaScript 无法访问，防止 XSS 攻击
- Cookie 使用 **SameSite=Lax** 策略，防止 CSRF 攻击
- 令牌仅在 HTTPS 连接中传输（生产环境）

#### 语言切换

**访问方式**：导航栏右上角选择**"中文"**或**"English"**

**支持语言**：
- 🇨🇳 **中文**：完整的简体中文界面
- 🇺🇸 **English**：完整的英文界面

**语言设置保存**：语言偏好会保存在 Cookie 中，下次访问自动应用（有效期 1 年）

#### 管理页面（仅管理员）

**访问方式**：导航到 `/admin`

**可配置项**：
- **最大上传文件大小**：调整参考图/参考视频的文件大小限制（1-1024 MB）
- **系统诊断信息**：
  - API Base URL
  - Token 配置状态
  - 当前上传限制

---

## 详细使用教程

### 教程 1：生成一个自然风光视频

**目标**：生成一个美丽的山间日落视频

**步骤**：

1. **进入工作台**
   - 点击导航栏的**"工作台"**或首页的**"快速体验"**按钮

2. **确保选择视频模式**
   - 工作台顶部应显示**"视频生成"**按钮为高亮状态
   - 如未高亮，点击切换

3. **输入提示词**
   ```
   壮观的山间日落，金色的阳光洒在雪山之巅，
   云海翻腾，镜头缓慢推进，电影级画质，16:9横屏构图
   ```
   
   **或点击快速标签**：
   - 点击"🌿 自然风光"标签，系统会自动填充一个相关提示词
   - 您可以根据需要修改提示词

4. **设置参数**
   - **模型**：选择 `sora-2-landscape-15s`（横屏15秒优化）
   - **画面比例**：选择 `HD 16:9 (1792x1024) 横屏`
   - **时长**：选择 `15秒`
   - **水印**：选择 `无水印（高清）`
   - 其他参数保持默认

5. **开始生成**
   - 点击**"生成"**按钮
   - 按钮会显示"正在生成…"，表示任务已提交

6. **查看进度**
   - 页面底部的**"最近生成记录"**会显示新任务
   - 状态显示"排队中"或"生成中"
   - 进度条实时更新（如 35%、67%、100%）
   - 系统每 10 秒自动刷新状态

7. **查看结果**
   - 生成完成后，状态变为"完成"，显示绿色徽章
   - 预览区域显示视频第一帧
   - 点击预览区域，全屏播放视频
   - 点击**"下载"**按钮，保存视频到本地

**预计时间**：通常 2-5 分钟，具体取决于服务器负载

---

### 教程 2：生成一个赛博朋克风格的图片

**目标**：生成一张赛博朋克风格的城市夜景图片

**步骤**：

1. **进入工作台并切换到图片模式**
   - 点击导航栏的**"工作台"**
   - 点击**"图片生成"**按钮切换模式（按钮会变为高亮蓝色）

2. **输入提示词**
   ```
   赛博朋克风格的未来城市夜景，霓虹灯闪烁，
   摩天大楼林立，飞行汽车穿梭，紫色和蓝色的霓虹色调，
   高细节，电影级渲染，雨夜氛围
   ```
   
   **或使用风格标签**：
   - 点击"🤖 赛博朋克"标签
   - 系统会自动生成相关风格的提示词

3. **设置参数**
   - **模型**：选择 `Gemini 3 Pro Image Preview`（推荐）
   - **宽高比**：选择 `16:9 (横屏)`
   - **图片尺寸**：选择 `2K`（推荐）
   - 不上传参考图（从零生成）

4. **开始生成**
   - 点击**"生成"**按钮
   - 提示"正在生成…"

5. **查看结果**
   - 图片生成通常很快（10-30 秒）
   - 完成后，任务卡片显示生成的图片缩略图
   - 点击图片，放大查看完整分辨率
   - 右键保存图片，或点击**"下载"**按钮

**提示**：图片生成比视频生成快得多，通常 10-30 秒即可完成。

---

### 教程 3：使用参考图编辑图片

**目标**：将一张普通照片转换为油画风格

**步骤**：

1. **准备参考图**
   - 准备一张您想要编辑的图片（JPG 或 PNG 格式）
   - 确保文件大小不超过 20MB

2. **进入图片生成模式**
   - 工作台 → **"图片生成"**

3. **输入编辑提示词**
   ```
   将这张照片转换为油画风格，梵高印象派手法，
   色彩鲜艳，笔触明显，保留原有构图
   ```
   
   **编辑提示词技巧**：
   - 明确说明要做什么改变（"转换为"、"添加"、"移除"、"改变"）
   - 说明保留什么（"保留原有构图"、"保持主体不变"）

4. **上传参考图**
   - 点击"参考图"上传区域的**"选择文件"**
   - 或直接将图片拖拽到上传区域
   - 上传成功后会显示文件名

5. **设置参数**
   - **模型**：`Gemini 3 Pro Image Preview`
   - **宽高比**：根据原图比例选择（如原图是横图，选 16:9）
   - **尺寸**：`2K`

6. **生成并查看**
   - 点击**"生成"**
   - 等待 10-30 秒
   - 对比原图和生成的油画风格图片

**更多编辑示例**：
```
在这张图片中添加一只白猫，融入场景
Add falling snow to this scene, keep everything else unchanged
Change this day scene to night time with stars
将这张照片的背景模糊化，突出主体
```

---

### 教程 4：查看任务详情和日志

**目标**：了解任务的完整处理过程

**步骤**：

1. **找到任务**
   - 在**"工作台"**的最近生成记录中
   - 或在**"任务"**列表页中

2. **进入任务详情**
   - 点击任务卡片上的**"任务详情"**按钮
   - 或点击**"查看详情"**链接

3. **查看实时状态**
   - 页面顶部显示当前状态（排队中/生成中/完成/失败）
   - 如果正在生成：
     - 进度百分比实时更新
     - 显示已用时间（如"已用 1 分 23 秒"）
     - 显示预计剩余时间（如"预计还需 2 分钟"）
   - 页面每 2 秒自动刷新

4. **查看任务日志**
   - 向下滚动到"任务日志"区域
   - 日志按时间倒序排列（最新的在上面）
   - 每条日志显示：
     - **时间**：相对时间（如"刚刚"、"30秒前"、"2分钟前"）
     - **状态**：提交/排队/生成中/完成/失败
     - **进度**：百分比（如果有）
     - **出现次数**：如果同一状态连续出现多次，会显示次数

5. **查看生成内容**（完成的任务）
   - 点击**"查看内容"**按钮
   - 进入内容播放/查看页面
   - 视频：在线播放，支持进度控制、音量调节、全屏
   - 图片：高清查看，可缩放
   - 点击**"下载"**按钮保存到本地

6. **返回**
   - 点击**"返回"**按钮
   - 系统会智能跳转到您来源的页面（工作台或任务列表）

**实用场景**：
- **排查问题**：如果任务失败，查看日志了解失败原因
- **监控进度**：实时了解长时间任务的处理进度
- **记录保存**：查看历史任务的完整信息

---

### 教程 5：使用快速提示词库

**目标**：快速生成高质量内容而无需自己编写提示词

**视频模式快速提示词**：

1. **使用分类标签**（推荐）
   - 工作台提示词输入框下方有 5 个分类标签
   - 每个标签对应一个内容类别：
     - 🌿 **自然风光**：10+ 个精选自然场景提示词
     - 🏙️ **城市景观**：10+ 个城市和建筑场景
     - ✨ **奇幻魔法**：10+ 个魔法和科幻场景
     - 🏃 **动作运动**：10+ 个运动和动态场景
     - 🍜 **美食特写**：10+ 个美食相关场景
   - **操作**：点击任意标签，系统从该类别随机选择一个提示词

2. **使用随机提示词按钮**
   - 提示词输入框右上角的**"随机提示词"**按钮
   - 点击后，从所有类别（50+ 个提示词）中随机选择
   - **操作**：反复点击，直到找到满意的提示词

3. **编辑和调整**
   - 系统填充提示词后，您可以：
     - 直接使用（点击生成）
     - 修改细节（添加或删除描述）
     - 结合多个提示词（手动组合不同元素）

**图片模式快速提示词**：

1. **使用风格标签**
   - 图片模式下，标签变为风格类型：
     - 🤖 赛博朋克
     - 🎨 艺术风格
     - 🎮 像素艺术
     - 🌸 日式动漫
     - 🔮 魔法奇幻
     - 🚀 科幻未来
   - **操作**：点击标签，随机生成该风格的提示词

2. **随机提示词**
   - 从 20+ 个精选图片提示词中随机选择
   - 涵盖各种艺术风格和主题

**提示词库的优势**：
- ✅ **专业编写**：所有提示词都经过优化，生成效果好
- ✅ **中英双语**：根据界面语言自动切换
- ✅ **快速上手**：无需学习如何编写提示词
- ✅ **灵感来源**：即使不直接使用,也可以作为参考

**示例工作流程**：
```
1. 点击"🌿 自然风光"
2. 系统填充："金色的麦田随风摇曳，远处是连绵起伏的山峦和蓝天白云"
3. 修改："金色的麦田随风摇曳，远处是雪山和蓝天白云，傍晚金色阳光"
4. 选择参数：sora-2-landscape-15s, 16:9, 15秒
5. 点击"生成"
```

---

## 界面导航

### 导航栏（所有页面顶部）

```
[Logo] AI Gen     工作台 | 任务 | 设置 | 退出 | 官方网站 | 中文 | English
```

- **Logo/品牌名**：点击返回首页
- **工作台**：视频/图片生成界面
- **任务**：查看所有历史任务
- **设置**：配置令牌、查看账户信息
- **退出**：清除令牌，退出当前会话
- **官方网站**：访问平台官方网站
- **语言切换**：中文 / English

### 首页（Landing Page）

**页面元素**：
- **标题动画**：渐变色"AIGen"标题，带浮动和发光动效
- **副标题**："AI 驱动的视频图像生成平台"
- **快速体验按钮**：直接跳转到工作台
- **查看任务按钮**：查看任务列表
- **功能卡片**：
  - 🎬 视频生成：Sora 系列，创意视频
  - 🖼️ 图像创作：AI 绘图，创新图像
  - ⚡ 批量处理：高吞吐，批量自动化
- **动态背景**：星空粒子动画，支持鼠标交互（移动/点击）

### 工作台页面（Studio）

**布局结构**：
```
┌─────────────────────────────────────────────────────┐
│ AI 创意工坊                                          │
│ 视频 · 图像 · 一键生成                              │
├─────────────────────────────────────────────────────┤
│ [视频生成] [图片生成]  ← 模式切换按钮               │
├─────────────────────────────────────────────────────┤
│ ┌─────────────────────────────────────────────────┐ │
│ │ 💡 描述你想要生成的视频或图片... [随机提示词]   │ │
│ │ ┌───────────────────────────────────────────┐   │ │
│ │ │ [提示词输入框]                    [生成] │   │ │
│ │ └───────────────────────────────────────────┘   │ │
│ │ 🌿自然风光 🏙️城市景观 ✨奇幻魔法 ...            │ │
│ └─────────────────────────────────────────────────┘ │
├─────────────────────────────────────────────────────┤
│ [模型] [画面比例] [时长]     ← 参数设置区           │
│ [参考图] [水印] [角色URL] [时间戳]                  │
├─────────────────────────────────────────────────────┤
│ 最近生成记录                              [刷新]    │
│ ┌────────┐ ┌────────┐ ┌────────┐ ┌────────┐        │
│ │任务卡片│ │任务卡片│ │任务卡片│ │任务卡片│        │
│ │[预览]  │ │[预览]  │ │[预览]  │ │[预览]  │        │
│ │进度 85%│ │完成    │ │排队中  │ │失败    │        │
│ └────────┘ └────────┘ └────────┘ └────────┘        │
└─────────────────────────────────────────────────────┘
```

**页面特性**：
- **深色主题**：舒适的深蓝色渐变背景
- **响应式布局**：自动适配桌面和移动设备
- **实时更新**：任务状态自动刷新
- **拖拽上传**：支持拖拽文件到上传区域

### 任务列表页（Tasks）

**页面结构**：
```
┌─────────────────────────────────────────────────────┐
│ 我的任务                                             │
│ ┌─────────────────────────────────────────────┐     │
│ │ 快速查找：[输入任务 ID]          [查找]      │     │
│ └─────────────────────────────────────────────┘     │
├─────────────────────────────────────────────────────┤
│ ┌─────────────────────────────────────────────────┐ │
│ │ 任务 ID: task_abc123                  [完成]   │ │
│ │ 模型: sora-2-landscape-15s                      │ │
│ │ 提示词: 一只蝴蝶在花园里飞舞...                │ │
│ │ 创建时间: 12月23日 14:32                        │ │
│ │ [查看详情] [下载]                               │ │
│ └─────────────────────────────────────────────────┘ │
│ ┌─────────────────────────────────────────────────┐ │
│ │ 任务 ID: task_def456                  [失败]   │ │
│ │ 模型: gemini-3-pro-image-preview                │ │
│ │ 提示词: 赛博朋克风格的猫...                    │ │
│ │ 创建时间: 12月23日 13:15                        │ │
│ │ [查看详情]                                      │ │
│ └─────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────┘
```

**功能**：
- 所有历史任务，按时间倒序
- 任务筛选和快速查找
- 状态一目了然
- 直接操作（查看/下载）

### 任务详情页（Task Detail）

**页面结构**：
```
┌─────────────────────────────────────────────────────┐
│ [返回工作台/任务列表]                               │
├─────────────────────────────────────────────────────┤
│ 任务详情                                             │
│                                                      │
│ 任务 ID: task_abc123                                │
│ 模型: sora-2-landscape-15s                          │
│ 提示词: 一只蝴蝶在五彩缤纷的花园里飞舞...          │
│ 创建时间: 2024-12-23 14:32:15                       │
├─────────────────────────────────────────────────────┤
│ ┌─────────────────────────────────────────────────┐ │
│ │ 当前状态: 生成中          🟡                    │ │
│ │ 进度: ████████░░░░░░░░░░  67%                   │ │
│ │ 已用时间: 1 分 45 秒                             │ │
│ │ 预计剩余: 约 1 分钟                              │ │
│ └─────────────────────────────────────────────────┘ │
├─────────────────────────────────────────────────────┤
│ 任务日志                                             │
│ ┌─────────────────────────────────────────────────┐ │
│ │ [生成中] 67%                    30秒前          │ │
│ │ [生成中] 45%                    1分钟前         │ │
│ │ [排队中]                        2分钟前         │ │
│ │ [已提交]                        2分钟前         │ │
│ └─────────────────────────────────────────────────┘ │
├─────────────────────────────────────────────────────┤
│ [查看内容]                                          │
└─────────────────────────────────────────────────────┘
```

**实时更新**：
- 状态每 2 秒刷新
- 进度条平滑动画
- 时间自动更新

---

## 常见问题

### 1. 令牌相关

#### Q: 如何获取令牌？
**A**: 令牌由自己登录 AIGen 中转站（网址：[https://blog.tuiwen.xyz](https://blog.tuiwen.xyz)）创建。令牌用于调用 AI 生成服务，每个用户应有独立的令牌。

#### Q: 令牌额度不足怎么办？
**A**: 如果生成时提示"令牌额度不足"或"Token quota exhausted"，说明您的令牌额度已用完。请联系管理员为您的令牌充值。

**常见提示**：
- 中文："令牌额度不足，请联系管理员充值！"
- 英文："Token quota exhausted, please contact the administrator to recharge."

#### Q: 令牌状态不可用是什么意思？
**A**: 说明您的令牌已被禁用或状态异常。可能原因：
- 令牌已过期
- 令牌被管理员禁用
- 令牌格式错误

**解决方法**：联系管理员检查令牌状态，或重新获取有效的令牌。

#### Q: 令牌保存后多久过期？
**A**: 令牌保存在 Cookie 中，有效期 **90 天**。90 天后需要重新输入。如果您清除了浏览器 Cookie，也需要重新输入。

#### Q: 我可以在多个设备上使用同一个令牌吗？
**A**: 可以。同一个令牌可以在多个设备、多个浏览器上使用。但请注意：
- 不要泄露您的令牌给其他人
- 所有设备共享同一个令牌额度
- 令牌使用记录可能被管理员监控

---

### 2. 视频生成相关

#### Q: 视频生成需要多长时间？
**A**: 通常 **2-5 分钟**，具体取决于：
- **视频时长**：20 秒视频比 10 秒视频慢
- **视频质量**：HD 高清模型比标准模型慢
- **服务器负载**：高峰期可能需要排队
- **内容复杂度**：复杂场景生成时间更长

**各阶段时间**：
- 排队：0-30 秒
- 生成：1-5 分钟
- 总计：2-6 分钟

#### Q: 视频生成失败的常见原因？
**A**: 
1. **令牌额度不足**：最常见，联系管理员充值
2. **内容违规**：
   - 角色视频中出现真人
   - 提示词包含敏感词汇
   - 生成内容违反平台规则
3. **角色时间戳错误**：时间差值不在 1-3 秒范围内
4. **参考图文件过大**：超过 20MB 限制
5. **网络错误**：连接上游服务失败（暂时性，可重试）

#### Q: 如何提高视频生成质量？
**A**: 
- **使用优化模型**：
  - 横屏视频：选择 `sora-2-landscape-15s`
  - 竖屏视频：选择 `sora-2-portrait-15s`
  - 新一代模型：选择 `sora_video2`
- **优化提示词**：
  - 详细描述场景、动作、光线、氛围
  - 添加画质描述（"电影级画质"、"高清细节"）
  - 说明镜头运动（"镜头推进"、"缓慢旋转"）
- **选择合适的比例和时长**：
  - 横屏视频选 16:9
  - 竖屏短视频选 9:16
  - 时长 15 秒是性价比最高的选择
- **使用参考图**：上传高质量参考图，帮助 AI 理解您的需求
- **选择无水印**：生成高清无水印版本

#### Q: 角色视频功能如何使用？
**A**: 
**用途**：在生成的视频中使用特定角色（卡通、动画等虚拟角色）

**步骤**：
1. 准备角色视频 URL（必须是可公开访问的链接）
2. 确定角色清晰出现的时间段（如 1-3 秒）
3. 在"角色视频链接"中输入 URL
4. 在"角色时间戳"中输入 `起始秒,结束秒`（如 `1,3`）
5. 提示词中描述角色的动作和场景

**示例**：
```
角色视频链接: https://example.com/character.mp4
角色时间戳: 1,3
提示词: 卡通猫咪在森林中奔跑，阳光透过树叶洒下，欢快的氛围
```

**重要限制**：
- ⚠️ 视频中**不能出现真人**，否则会失败
- ⚠️ 时间差值必须在 **1-3 秒**之间
- ⚠️ URL 必须是可公开访问的视频链接

#### Q: 为什么我的视频生成进度卡在某个百分比不动？
**A**: 可能原因和解决方法：
1. **正常现象**：某些阶段（如 0%、50%、90%）可能会停留较久，这是正常的。请耐心等待。
2. **网络问题**：如果超过 10 分钟没有进展，可能是网络问题。刷新页面，任务仍在后台处理。
3. **服务器繁忙**：高峰期可能速度变慢。查看任务详情页的日志，确认是否还在处理。
4. **任务失败**：如果最终失败，会显示失败状态和具体原因。

**建议**：
- 前 5 分钟：耐心等待，不要刷新
- 5-10 分钟：查看任务详情页，确认状态
- 超过 10 分钟：联系管理员检查服务状态

---

### 3. 图片生成相关

#### Q: 图片生成需要多长时间？
**A**: 通常 **10-30 秒**，比视频生成快很多。

**各尺寸时间**：
- 1K：10-15 秒
- 2K：15-25 秒
- 4K：25-45 秒

#### Q: 图片编辑功能如何使用？
**A**: 
**用途**：基于现有图片进行 AI 辅助编辑或风格转换

**步骤**：
1. 切换到**"图片生成"**模式
2. 上传您想要编辑的图片（参考图）
3. 在提示词中描述想要的改变：
   - 风格转换："将这张照片转换为水彩画风格"
   - 添加元素："在这张图片中添加一只白猫"
   - 改变氛围："将这个白天场景变成夜晚"
   - 调整颜色："增强色彩饱和度，暖色调"
4. 选择参数（宽高比应与原图接近）
5. 点击生成

**提示词技巧**：
- 明确说明要改变什么
- 说明要保留什么（"保留原有构图"）
- 可以多次尝试，调整提示词

**示例提示词**：
```
将这张照片转换为油画风格，梵高印象派手法，保留原有构图
Add falling cherry blossoms to this scene, spring atmosphere
在图片中添加一只黑猫，坐在窗台上，融入场景
Change the background to a starry night sky, keep the foreground unchanged
```

#### Q: 如何选择合适的宽高比和尺寸？
**A**: 
**宽高比选择**：
- **16:9（横屏）**：桌面壁纸、横版海报、演示文稿
- **9:16（竖屏）**：手机壁纸、社交媒体故事、竖版海报
- **1:1（方形）**：头像、方形海报、Instagram 帖子
- **21:9（超宽）**：电影画幅、超宽屏壁纸
- **其他比例**：特定用途（如 2:3 适合印刷海报）

**尺寸选择**：
- **1K**：快速预览、草稿、低分辨率需求
- **2K（推荐）**：大多数用途，平衡质量和速度
- **4K**：高分辨率需求、印刷、专业用途（但生成较慢）

**建议**：
- 初次尝试：使用 2K + 16:9 或 1:1
- 手机壁纸：9:16 + 2K
- 印刷海报：对应比例 + 4K
- 快速测试：1:1 + 1K

---

### 4. 任务管理相关

#### Q: 什么是游客模式？和注册用户有什么区别？
**A**: 
**游客模式**：
- 无需注册即可使用，适合快速体验
- 任务数据存储在浏览器缓存和服务器内存中
- 服务器重启后任务会丢失
- 更换浏览器或设备后无法查看之前的任务

**注册用户模式**：
- 任务数据永久保存到数据库
- 支持跨设备访问
- 服务器重启后任务不会丢失
- 建议长期使用的用户注册账号

**如何注册**：
- 点击导航栏的"注册"按钮
- 输入用户名和密码
- 注册后自动登录，之后创建的任务会永久保存

#### Q: 为什么我看不到其他人的任务？
**A**: AIGen 实现了**用户会话隔离**机制：
- 每个用户有独立的会话 ID（存储在 Cookie 中）
- 您只能看到自己创建的任务
- 即使知道其他人的任务 ID，也无法访问

**目的**：保护用户隐私和数据安全。

#### Q: 我换了浏览器/设备，为什么看不到之前的任务？
**A**: 
**游客模式**：
- 会话 ID 存储在浏览器 Cookie 中，换浏览器/设备后 Cookie 不会同步
- 因此无法查看之前的任务
- **解决方法**：注册账号，任务会永久保存并支持跨设备访问

**注册用户**：
- 登录账号后，所有任务都会保存到数据库
- 在任何设备上登录同一账号，都可以查看所有历史任务
- 支持跨设备同步

#### Q: 任务状态不更新怎么办？
**A**: 
1. **手动刷新**：点击"刷新"按钮
2. **检查网络**：确保网络连接正常
3. **清除缓存**：按 Ctrl+F5（Windows）或 Cmd+Shift+R（Mac）强制刷新
4. **查看详情页**：进入任务详情页，那里的刷新更频繁（每 2 秒）
5. **等待**：如果任务正在排队，可能需要等待一段时间才会开始

#### Q: 任务能保存多久？
**A**: 当前版本中，任务数据存储在服务器内存中：
- **服务器运行期间**：任务数据一直保存
- **服务器重启后**：任务数据会丢失
- **建议**：完成的任务及时下载保存

**未来版本**：计划支持数据库持久化存储。

#### Q: 如何下载生成的视频/图片？
**A**: 
**方法一**：任务卡片下载按钮
- 在"最近生成记录"或"任务列表"中
- 点击任务卡片上的**"下载"**按钮
- 文件会自动下载到浏览器默认下载文件夹

**方法二**：查看内容页下载
- 进入任务详情页
- 点击**"查看内容"**
- 在播放/查看页面，点击**"下载"**按钮

**方法三**：右键保存（仅图片）
- 在预览区域，右键点击图片
- 选择"图片另存为..."
- 选择保存位置

**视频格式**：MP4（H.264 编码，通用格式）  
**图片格式**：PNG（高质量无损格式）

---

### 5. 技术和性能相关

#### Q: 为什么页面加载慢或操作卡顿？
**A**: 可能原因和解决方法：
1. **网络问题**：检查网络连接速度
2. **浏览器缓存**：清除浏览器缓存和 Cookie
3. **浏览器版本过旧**：更新到最新版本的 Chrome、Edge 或 Firefox
4. **服务器负载**：高峰期可能响应变慢，稍后再试
5. **大文件上传**：上传大参考图时会变慢，建议压缩图片到 5MB 以下

#### Q: 支持哪些浏览器？
**A**: 
**推荐浏览器**（最佳体验）：
- ✅ Google Chrome 90+
- ✅ Microsoft Edge 90+
- ✅ Firefox 88+
- ✅ Safari 14+（Mac/iOS）

**不推荐**：
- ❌ Internet Explorer（任何版本）
- ❌ 过旧版本的浏览器

**建议**：使用最新版本的 Chrome 或 Edge 以获得最佳体验。

#### Q: 可以在手机上使用吗？
**A**: 可以！AIGen 采用响应式设计，完全支持移动设备。

**移动端体验**：
- ✅ 所有核心功能可用
- ✅ 界面自动适配屏幕尺寸
- ✅ 触摸操作优化
- ✅ 拖拽上传支持移动选择文件

**移动端建议**：
- 使用 WiFi 而非移动数据（视频文件较大）
- 横屏使用以获得更好的视觉效果
- 避免在移动端上传特别大的参考图

#### Q: 视频/图片质量能达到多少？
**A**: 
**视频质量**：
- **标准模型**（sora-2）：720p - 1080p
- **新一代模型**（sora_video2）：1080p
- **方向特化模型**（landscape/portrait-15s）：1080p - 1440p
- **帧率**：通常 24-30 FPS
- **编码**：H.264，通用兼容格式

**图片质量**：
- **1K**：约 1024 像素长边
- **2K**：约 2048 像素长边（推荐）
- **4K**：约 4096 像素长边
- **格式**：PNG（无损）
- **色彩**：RGB，8位色深

**质量影响因素**：
- 模型选择（HD > 标准）
- 提示词质量（详细描述 > 简单描述）
- 参考图质量（高清参考图 > 低清参考图）

---

### 6. 错误和故障排除

#### Q: 提示"Access denied"或"403"错误
**A**: 这表示您尝试访问不属于您的任务。

**可能原因**：
1. 任务属于其他用户
2. 您的会话 Cookie 已过期或被清除
3. 任务 ID 错误

**解决方法**：
- 返回工作台或任务列表，查看您自己的任务
- 如果清除了 Cookie，之前的任务将无法访问
- 确保任务 ID 输入正确

#### Q: 上传文件时提示"413 File too large"
**A**: 您上传的文件超过了大小限制（默认 20MB）。

**解决方法**：
1. **压缩图片**：使用图片编辑工具（如 Photoshop、在线压缩工具）压缩图片
   - 调整分辨率（如从 4K 降到 2K）
   - 调整质量（JPG 质量设为 80-90%）
   - 转换格式（PNG 转 JPG 通常能减小文件大小）
2. **联系管理员**：如有必要，管理员可以在 `/admin` 页面调整上传限制
3. **使用 URL 代替**（角色视频）：将视频上传到其他服务，使用 URL 而非直接上传

#### Q: 提示"Network error"或连接失败
**A**: 网络问题导致无法连接到服务器或上游 API。

**排查步骤**：
1. **检查网络连接**：确保您的设备联网
2. **刷新页面**：按 F5 或点击浏览器刷新按钮
3. **检查 VPN/代理**：如果使用 VPN，尝试断开后重试
4. **稍后重试**：可能是服务器暂时性故障，等待 5-10 分钟后重试
5. **联系管理员**：如果长时间无法连接，可能是服务器故障

#### Q: 视频无法播放或只有声音没有画面
**A**: 
**可能原因**：
1. 浏览器不支持 H.264 编码
2. 视频文件损坏（生成过程中出错）
3. 网络问题导致下载不完整

**解决方法**：
1. **更换浏览器**：尝试使用 Chrome 或 Edge
2. **下载后播放**：下载视频到本地，使用 VLC 或其他播放器
3. **重新生成**：如果视频确实损坏，重新提交生成任务
4. **检查网络**：确保网络稳定，特别是查看大文件时

#### Q: 页面显示乱码或样式错乱
**A**: 
**解决方法**：
1. **强制刷新**：按 Ctrl+Shift+R（Windows）或 Cmd+Shift+R（Mac）
2. **清除缓存**：
   - Chrome：设置 → 隐私和安全 → 清除浏览数据 → 缓存的图片和文件
   - Firefox：设置 → 隐私与安全 → Cookie 和站点数据 → 清除数据
3. **检查网络**：部分 CSS/JS 文件可能未加载完成
4. **更新浏览器**：使用最新版本浏览器

---

## 技术规格

### 系统架构

**前端技术**：
- **HTML5 + Jinja2 模板**：服务端渲染
- **Tailwind CSS**：样式框架（CDN 引入）
- **HTMX**：动态内容加载和表单提交
- **原生 JavaScript**：交互逻辑、状态管理、轮询

**后端技术**：
- **FastAPI**：Python Web 框架
- **Uvicorn/Gunicorn**：ASGI 服务器
- **httpx**：异步 HTTP 客户端
- **Jinja2**：模板引擎

**数据存储**：
- **内存存储**：任务状态、日志、图片缓存（`app.state`）
- **Cookie**：用户会话、Token、语言偏好
- **LocalStorage**：Token 本地备份（方便自动填充）

### API 规格

#### 上游 API

**Sora API（视频生成）**：
- **端点**：`{SORA_API_BASE}/v1/videos`
- **方法**：POST
- **认证**：Bearer Token（Authorization 头）
- **格式**：multipart/form-data

**Gemini API（图片生成）**：
- **端点**：`{SORA_API_BASE}/v1beta/models/{model}:generateContent`
- **方法**：POST
- **认证**：API Key（x-goog-api-key 头）
- **格式**：JSON

#### 平台 API

详细的 API 文档请参考 `API_DOCUMENTATION.md`。

**主要端点**：
- `POST /submit-inline`：提交视频生成任务
- `POST /submit-image-inline`：提交图片生成任务
- `GET /api/videos/{task_id}`：查询视频任务状态
- `GET /api/images/{task_id}`：查询图片任务状态
- `GET /proxy/videos/{task_id}/content`：代理视频内容
- `GET /proxy/images/{task_id}/content`：代理图片内容
- `POST /set-token`：设置 Token
- `GET /status-fragment/{task_id}`：获取状态 HTML 片段
- `GET /recent-tasks-fragment`：获取最近任务 HTML 片段

### 性能指标

**响应时间**：
- 页面加载：< 1 秒
- API 响应：< 500ms（查询任务状态）
- 视频代理：流式传输，支持 Range 请求

**并发能力**：
- 支持多用户同时使用
- 任务状态轮询不会影响其他用户
- 图片缓存存储在内存中，访问速度快

**文件限制**：
- 上传文件大小：20MB（默认，可调整到 1-1024MB）
- 支持的图片格式：JPG、PNG、GIF、WEBP 等常见格式
- 视频输出格式：MP4（H.264）

### 安全特性

**认证与授权**：
- Token 认证（Bearer Token 或 API Key）
- 用户会话隔离（基于 Cookie 的会话 ID）
- 任务权限验证（仅任务所有者可访问）

**数据保护**：
- HttpOnly Cookie（防止 XSS 攻击）
- SameSite=Lax（防止 CSRF 攻击）
- 不在浏览器 JavaScript 中暴露 Token

**隐私保护**：
- 每个用户只能看到自己的任务
- 会话 ID 基于 UUID，随机且唯一
- 图片缓存按用户隔离

---

## 最佳实践

### 提示词编写最佳实践

#### 视频提示词

**结构化描述**：
```
[主体] + [动作] + [环境] + [光线/氛围] + [镜头运动] + [画质要求]
```

**示例**：
```
一只蝴蝶（主体）在花园中飞舞（动作），
五彩缤纷的花朵和绿色草地（环境），
阳光透过树叶洒下斑驳光影（光线），
镜头缓慢跟随蝴蝶移动（镜头），
电影级画质，高清细节（画质）
```

**常用描述词**：
- **动作**：飞舞、流动、旋转、奔跑、飘落、翻滚、跳跃
- **光线**：阳光、月光、霓虹、逆光、暖光、冷光、柔光
- **氛围**：温馨、神秘、欢快、紧张、宁静、梦幻、激烈
- **镜头**：推进、拉远、跟随、环绕、俯拍、仰拍、第一人称
- **画质**：电影级、高清、细节丰富、写实、艺术化

**避免**：
- ❌ 过于简短："一只猫"
- ❌ 缺少动作："美丽的风景"（静态）
- ❌ 过于抽象："幸福的感觉"

**推荐**：
- ✅ 详细具体："一只橘色的猫咪在阳光下的草地上慵懒地伸懒腰"
- ✅ 有动态："樱花花瓣随风飘落，镜头缓缓推进到一朵盛开的樱花"
- ✅ 形象化："夜晚的城市街道，霓虹灯闪烁，雨水在地面上反射出五彩光芒"

#### 图片提示词

**结构化描述**：
```
[主体] + [风格] + [细节] + [颜色/光线] + [构图] + [参考]
```

**示例**：
```
赛博朋克风格的猫咪（主体+风格），
戴着发光的VR眼镜，金属质感的项圈（细节），
紫色和蓝色的霓虹色调，强烈的对比光（颜色+光线），
半身特写，背景是模糊的城市夜景（构图），
类似《银翼杀手》的视觉风格（参考）
```

**风格关键词**：
- **艺术风格**：油画、水彩、素描、版画、拼贴、波普艺术
- **流派**：印象派、超现实主义、立体主义、极简主义
- **视觉风格**：赛博朋克、蒸汽朋克、低多边形、像素艺术、扁平化
- **渲染风格**：3D 渲染、照片写实、卡通、动漫、矢量图

**技术关键词**：
- **光线**：自然光、工作室灯光、边缘光、体积光、光线追踪
- **质感**：金属、玻璃、木质、布料、液体、半透明
- **细节**：高细节、精致、宏观、微距、纹理丰富
- **构图**：居中、三分法、对称、黄金分割、仰视、俯视

**颜色描述**：
- **色调**：暖色调、冷色调、单色、双色、彩虹色、渐变
- **饱和度**：鲜艳、柔和、褪色、高饱和、低饱和
- **对比**：高对比、低对比、黑白、明暗对比

### 参数选择最佳实践

#### 视频参数

| 用途 | 模型 | 比例 | 时长 | 水印 |
|------|------|------|------|------|
| 快速预览测试 | sora-2 | 16:9 (1280x720) | 10秒 | 带水印 |
| 标准横屏视频 | sora-2-landscape-15s | 16:9 (1792x1024) | 15秒 | 无水印 |
| 社交媒体短视频 | sora-2-portrait-15s | 9:16 (1024x1792) | 15秒 | 无水印 |
| 新一代模型 | sora_video2 | 自动 | 10-15秒 | 无水印 |

#### 图片参数

| 用途 | 模型 | 宽高比 | 尺寸 |
|------|------|--------|------|
| 快速预览 | Preview | 1:1 | 1K |
| 社交媒体发布 | Preview | 1:1 或 9:16 | 2K |
| 桌面壁纸 | Preview | 16:9 | 2K-4K |
| 手机壁纸 | Preview | 9:16 | 2K |
| 印刷用途 | 正式版 | 根据需求 | 4K |
| 专业设计 | 正式版 | 根据需求 | 4K |

### 工作流程最佳实践

#### 高效生成流程

**步骤 1：明确需求**
- 确定内容类型（视频/图片）
- 确定用途和规格
- 确定风格和氛围

**步骤 2：准备素材**（如需要）
- 收集参考图片
- 压缩到合适大小（< 5MB 为佳）
- 确保图片清晰且相关

**步骤 3：编写提示词**
- 使用快速提示词库获取灵感
- 根据需求修改和优化
- 添加具体的细节描述

**步骤 4：选择参数**
- 根据用途选择模型和尺寸
- 首次测试可用较低参数（节省时间和额度）
- 满意后再用高参数重新生成

**步骤 5：提交和监控**
- 提交任务
- 监控进度（可以在工作台或详情页）
- 如有多个任务，可同时进行

**步骤 6：评估和优化**
- 查看生成结果
- 如不满意，分析问题（提示词？参数？）
- 调整后重新生成

#### 批量生成技巧

**场景**：需要生成多个相似但不同的内容

**方法**：
1. **参数固定，提示词变化**：
   - 确定最佳参数组合
   - 准备多个提示词变体
   - 依次提交（系统支持并发处理）

2. **提示词模板化**：
   ```
   模板: [主体] + 在 [环境] 中 [动作]，[氛围]
   
   变体 1: 蝴蝶在花园中飞舞，阳光明媚
   变体 2: 蜻蜓在池塘边停留，傍晚微风
   变体 3: 蜜蜂在花丛中采蜜，春天气息
   ```

3. **渐进式优化**：
   - 第一轮：使用低参数快速生成多个版本
   - 选择最佳版本
   - 第二轮：使用高参数重新生成选定版本

#### 令牌额度管理

**节省额度技巧**：
1. **先测试再高清**：用标准模型测试，满意后再用 HD
2. **合理选择时长**：10 秒够用时不选 20 秒
3. **避免重复生成**：仔细检查提示词和参数再提交
4. **使用参考图**：能提高成功率，减少重试次数

**额度使用参考**（假设值，实际请咨询管理员）：
- 10秒标准视频：约 1 额度
- 15秒 HD 视频：约 2-3 额度
- 20秒 Pro 视频：约 4-5 额度
- 2K 图片：约 0.5 额度
- 4K 图片：约 1 额度

---

## 附录

### 快捷键

当前版本支持的快捷键：
- **ESC**：关闭视频/图片模态框
- **Ctrl+F5 / Cmd+Shift+R**：强制刷新页面（清除缓存）

### 常用链接

- **工作台**：`/studio`
- **任务列表**：`/tasks`
- **管理页面**：`/admin`（仅管理员）
- **API 文档**：项目根目录的 `API_DOCUMENTATION.md`
- **技术文档**：项目根目录的 `README.md`

### 术语表

- **Token**：API 令牌，用于认证和调用 AI 生成服务
- **提示词（Prompt）**：描述想要生成内容的文字输入
- **宽高比（Aspect Ratio）**：图片/视频的长宽比例
- **参考图（Reference Image）**：用于辅助 AI 理解需求的图片
- **任务（Task）**：一次生成请求及其处理过程
- **会话 ID（Session ID）**：标识用户会话的唯一标识符
- **上游 API**：实际提供 AI 生成能力的第三方服务（Sora、Gemini）
- **代理（Proxy）**：平台转发上游 API 的内容，提供统一访问

### 更新日志

**v1.0.0**（当前版本）
- ✅ 视频生成功能（Sora API）
- ✅ 图片生成功能（Gemini API）
- ✅ 任务管理和状态追踪
- ✅ 用户会话隔离
- ✅ 中英双语支持
- ✅ 实时状态轮询
- ✅ 深色主题界面
- ✅ 快速提示词库
- ✅ 拖拽上传支持
- ✅ 响应式设计

**计划中的功能**：
- 🔲 用户账户系统（跨设备同步）
- 🔲 数据库持久化存储
- 🔲 批量生成和导出
- 🔲 任务分类和标签
- 🔲 收藏和分享功能
- 🔲 高级提示词编辑器
- 🔲 生成历史统计

---

## 获取支持

### 联系方式

- **技术支持**：联系您的系统管理员
- **问题反馈**：通过平台提供的反馈渠道
- **官方网站**：https://blog.tuiwen.xyz

### 常见问题快速索引

- [如何获取令牌？](#q-如何获取令牌)
- [令牌额度不足怎么办？](#q-令牌额度不足怎么办)
- [视频生成需要多长时间？](#q-视频生成需要多长时间)
- [如何提高视频生成质量？](#q-如何提高视频生成质量)
- [图片编辑功能如何使用？](#q-图片编辑功能如何使用)
- [为什么我看不到其他人的任务？](#q-为什么我看不到其他人的任务)

---

**感谢使用 AIGen！祝您创作愉快！** 🎨✨