创建测试用 Flask 应用

检查历史记录是否存在 用于前端在开始生成前检查草稿记录是否已创建。 路径参数： - record_id: 记录 ID 返回： - exists: 记录是否存在（boolean）

清理任务状态（释放内存）

* 清除生成的内容数据 * 重置为初始状态

创建测试客户端

批量压缩图片 Args: images: 图片数据列表 max_size_kb: 最大文件大小（KB） Returns: 压缩后的图片数据列表

创建历史记录（草稿） 在用户生成大纲后立即调用，创建一个草稿状态的历史记录。 初始状态为 draft，表示大纲已创建但尚未开始生成图片。 请求体： - topic: 主题标题（必填） - outli

* 删除图片服务商

* 删除指定索引的页面 * @param index 页面索引

* 删除文本服务商

删除历史记录 路径参数： - record_id: 记录 ID 返回： - success: 是否成功

下载历史记录的所有图片为 ZIP 文件 路径参数： - record_id: 记录 ID 返回： - 成功：ZIP 文件下载 - 失败：JSON 错误信息

* 完成图片生成流程 * @param taskId 生成任务的ID

生成标题、文案、标签 请求格式（application/json）： - topic: 主题文本 - outline: 大纲内容 返回： - success: 是否成功 - titl

生成图片 Args: prompt: 提示词 size: 图片尺寸 (如 "1024x1024", "2048x2048", "4096x4096") model: 模型名称

生成图片 Args: prompt: 提示词 aspect_ratio: 宽高比 (如 "3:4", "1:1", "16:9") temperature: 温度 mo

生成图片 Args: prompt: 提示词 **kwargs: 其他参数（如分辨率、宽高比等） Returns: 图片二进制数据

生成图片 Args: prompt: 图片描述 aspect_ratio: 宽高比 temperature: 创意度（未使用，保留接口兼容） model: 模型名称

批量生成图片（SSE 流式返回） 请求体： - pages: 页面列表（必填） - task_id: 任务 ID - full_outline: 完整大纲文本 - user_topic: 用户原始输入

生成大纲（支持图片上传） 请求格式： 1. multipart/form-data（带图片文件） - topic: 主题文本 - images: 图片文件列表 2. applicatio

生成文本（支持图片输入） Args: prompt: 提示词 model: 模型名称 temperature: 温度 max_output_tokens: 最大输出 t

* 获取所有生成失败的图片列表 * @returns 失败的图片数组

* 获取生成失败的图片对应的页面 * @returns 失败页面的数组

获取当前配置 返回： - success: 是否成功 - config: 配置对象 - text_generation: 文本生成配置 - image_generation: 图片生成配置

获取全局 GenAI 客户端实例

获取历史记录详情 路径参数： - record_id: 记录 ID 返回： - success: 是否成功 - record: 完整的记录数据

获取历史记录统计信息 返回： - success: 是否成功 - total: 总记录数 - by_status: 按状态分组的统计

获取图片文件 路径参数： - task_id: 任务 ID - filename: 文件名 查询参数： - thumbnail: 是否返回缩略图（默认 true） 返回：

获取图片完整路径 Args: task_id: 任务ID filename: 文件名 Returns: 完整路径

获取支持的宽高比

获取支持的宽高比 Returns: 支持的宽高比列表

获取支持的宽高比

获取支持的图片尺寸

获取支持的图片尺寸 Returns: 支持的尺寸列表

获取支持的图片尺寸

获取任务状态 路径参数： - task_id: 任务 ID 返回： - success: 是否成功 - state: 任务状态 - generated: 已生成的图片

* 检查是否存在生成失败的图片 * @returns true-存在失败的图片, false-所有图片都成功

* 检查是否有未保存的更改 * @returns true-有未保存的更改, false-没有未保存的更改

健康检查接口 返回： - success: 服务是否正常 - message: 状态消息

* 在指定位置后插入新页面 * @param afterIndex 在此索引后插入 * @param type 页面类型 * @param content 页面内容

获取历史记录列表（分页） 查询参数： - page: 页码（默认 1） - page_size: 每页数量（默认 20） - status: 状态过滤（可选：all/completed/draft）

加载文本生成服务商配置

* 标记已保存到服务器 * 更新最后保存时间为当前时间

* 移动页面位置（用于拖拽排序） * @param fromIndex 源位置索引 * @param toIndex 目标位置索引

* 打开添加图片服务商弹窗

* 打开添加文本服务商弹窗

* 打开编辑图片服务商弹窗

* 打开编辑文本服务商弹窗

重新生成图片（即使成功的也可以重新生成） 请求体： - task_id: 任务 ID（必填） - page: 页面信息（必填） - use_reference: 是否使用参考图（默认 true） -

注册自定义生成器 Args: name: 生成器名称 generator_class: 生成器类

重新加载配置（清除缓存）

* 重置所有状态到初始值 * 用于开始新的生成任务时清空之前的数据

批量重试失败的图片（SSE 流式返回） 请求体： - task_id: 任务 ID（必填） - pages: 要重试的页面列表（必填） 返回： SSE 事件流

429 错误自动重试装饰器（带智能错误解析）

429 错误自动重试装饰器

重试生成单张失败的图片 请求体： - task_id: 任务 ID（必填） - page: 页面信息（必填） - use_reference: 是否使用参考图（默认 true） 返回：

示例历史记录

示例大纲数据

示例页面数据

* 保存图片服务商

* 保存文本服务商

* 保存当前状态到 localStorage * 用于浏览器刷新后恢复状态

扫描所有任务并同步图片列表 返回： - success: 是否成功 - total_tasks: 扫描的任务总数 - synced: 成功同步的任务数 - failed: 失败的任务数

扫描单个任务并同步图片列表 路径参数： - task_id: 任务 ID 返回： - success: 是否成功 - images: 同步后的图片列表

搜索历史记录 查询参数： - keyword: 搜索关键词（必填） 返回： - success: 是否成功 - records: 匹配的记录列表

* 设置生成的内容数据 * @param titles 标题列表 * @param copywriting 文案内容 * @param tags 标签列表

* 设置内容生成失败的错误信息 * @param error 错误描述

* 设置指定图片为重试中状态 * @param index 页面索引

* 设置大纲数据 * @param raw 原始大纲文本 * @param pages 解析后的页面数组

* 设置大纲生成状态 * @param status 大纲生成状态：idle-未开始, generating-生成中, done-已完成, error-出错

* 设置历史记录ID（带验证） * @param recordId 历史记录ID，null表示清空

* 设置用户输入的主题 * @param topic 主题内容