AnyGen OpenAPI：异步生成任务 + 轮询状态 + 下载产出
OpenAPI 是什么
2026 年 3 月 AnyGen 更新中上线的核心能力——让开发者和 AI Agent（OpenClaw、Claude Code、Cursor 等）可以程序化调用 AnyGen 的全部生产力模块。
官网定位：
Supercharge OpenClaw / Claude Code with AnyGen OpenAPI: generate docs, slides, sites, and more — fast.
为什么需要 OpenAPI
Web UI 很强，但有些场景需要自动化：
- 批量生成：一次生成 100 份不同的销售 PPT
- Agent 集成：让 Claude Code 在代码里调用 AnyGen 生成文档
- CI/CD 流水线：文档变更后自动重新生成 PPT 和网页
- 自定义工作流：你有一套独特的文档/PPT 生成流程，需要代码层控制
核心模式：异步任务 + 轮询
AnyGen OpenAPI 是典型的异步任务模式：
- 创建任务：POST 请求提交生成要求
- 拿到任务 ID：API 返回 task_id
- 轮询状态：GET 请求查询 task_id 的状态（pending → running → completed / failed）
- 下载产出：completed 状态后，API 返回临时文件 URL（带过期时间）
支持的操作类型
| 操作 | 产出 | 可下载文件 |
|---|---|---|
slide | 幻灯片（PPT） | .pptx |
doc | 文档 | .docx 或 .pdf |
website | 网页 | HTML 或 React 源码 |
storybook | 图画书 | |
data_analysis | 数据分析 | 图表 + 摘要 |
smartdraw | SmartDraw 图示 | .pptx / .svg |
earnings_analysis | 财报深度分析 | 结构化报告 |
earnings_preview | 财报预演 | 场景建模 |
sector_scan | 跨板块对比 | 扫描报告 |
initiating_coverage | 股票深度覆盖 | 完整报告 |
valuation_analysis | 估值分析（DCF、可比公司） | 结构化报告 |
API 认证
用 AnyGen API Key 认证：
- 格式：
sk-... - 从 AnyGen 个人中心创建（Settings → API Keys → Create）
- 不要硬编码到代码里，用环境变量存储
可选参数
创建任务时可以控制：
- 语言：
zh-CN/en-US - 幻灯片页数
- 宽高比：16:9 / 4:3
- 模板：指定上传的 PPTX 模板
- 输出格式：docx / pdf
- 参考文件：Base64 编码的 PDF / 图片 / 文档
- 生成选项：Professional / Creative 风格、Nano Banana Pro / V2 模型
临时文件下载
任务完成后，API 返回的下载 URL 是临时的、带过期时间的：
- 过期时间在 metadata 里
- 过期后不能再下载，需要重新生成
- 建议下载到你自己的存储（OSS、S3、本地磁盘）做持久化
文档入口
AnyGen 提供了 API 文档的完整入口：
- 官方文档站的 llms.txt：给 AI Agent 看的文档索引
- OpenAPI 官方文档页：完整接口说明、认证方式、请求/响应示例
- Skills 仓库：AnyGen 官方 GitHub 上的 anygen-skills 仓库（给 AI Agent 的快捷集成）