DeckFlow 提供了强大的幻灯片文档自动生成、处理与优化能力。所有接口均统一在基础 Base URL https://app.deckflow.com/api 之下，并通过统一的 HTTP 请求头认证机制进行授权调用。
1. 主要产品工作流
DeckFlow 包含三大核心业务工作流，并附带一组独立的文件处理工具：
提交生成任务 (Create)
从多种类型的输入源智能生成全新、专业的幻灯片（PPTX）：
- 输入源类型：本地源文档（如 PDF、Word、Markdown）、网页链接（URL）或文本主题提示词（Prompt）。
- 参数控制：可通过参数指定页数（
pageCount）、长宽比（aspect ratio）、目标受众、作者，并控制是否启用网络搜索（enableSearch）或高级推理模型（advancedModel）。
提交焕新任务 (Revamp)
在完全保留源文稿数据、文本、数据结构与顺序的前提下，重新设计现有演示文稿的视觉外观：
- 输入文件：支持上传 PPTX、Keynote、PDF 格式文稿。
- 视觉风格：支持套用企业自定义的 品牌 DNA 配置文件或内置专业设计模版。
提交翻译任务 (Translate)
对文稿或办公文档进行多语言翻译，并在翻译后完美保持文稿原有的排版版面与字体动画：
- 输入文件：支持 PPTX、Keynote、PDF、Word、Excel 格式。
- 自定义选项：支持应用企业专属的 术语表 (Glossary)，确保专业名词的精准翻译。
2. 核心实体模型
异步任务 (Task)
由于文件处理与大模型生成属于重型计算，DeckFlow 全面采用异步任务驱动模型：
- 任务创建：通过
POST /tools/tasks接口提交源文件和参数，请求会立即返回，并提供一个唯一的任务标识符taskId。 - 状态轮询：开发者通过
GET /tools/tasks/{taskId}接口查询任务详情，或通过长连接实时接收任务进度状态。 - 状态生命周期：
queued（已排队）：等待后台队列分配计算资源。running（处理中）：后台引擎正在解析、生成或优化文件。completed（已成功）：任务成功完成，可以通过result.url获取下载链接。failed（已失败）：任务失败，可以通过error结构体查看具体错误码与排查方案。
配额计费 (Quotas)
DeckFlow 使用双币种配额计费模式：
- Credit：用于标准计算工作，包括 OCR 文本识别、文件格式转换、版式解析和普通的幻灯片生成/翻译。
- Spark：用于重型或高级计算工作，包括视频压缩、高级推理大模型生成和超大文件处理。
品牌 DNA (Brand DNA)
品牌 DNA 是工作空间内的全局设计规范配置文件。它定义了品牌专属的调色板、字体库、排版间距及特有的背景布局，被广泛用于 Create 和 Revamp 工作流中。
术语表 (Glossary)
术语表用于在 Translate 工作流中实现精细化的专有名词与品牌词匹配。用户可以预先上传特定领域的术语对，翻译引擎将在翻译过程中强制应用这些术语，从而避免译名不准确。