用途:通过 Gamma 的异步 Generate API 生成第一个演示文稿,适合学习 generate-poll-retrieve 工作流、测试 API 连通性,或创建最小化的演示内容。
主要能力:支持三种输出格式与异步生成模式。outputFormat 可选 presentation(幻灯片,默认)、document(长文档)、webpage(网页)、social_post(社交媒体内容)。工作流为:POST 提交生成请求获得 generationId;GET 轮询状态直至 completed 或 failed;结果返回 gammaUrl(应用内查看)和 exportUrl(下载 PDF/PPTX/PNG)。返回 opaque 测试 ID、schema/发布结果、owner 及脱敏失败引用,输出中不包含演示内容、凭据和查看者数据。
使用方式:前置条件为已完成 gamma-install-auth 设置、有效的 GAMMA_API_KEY 环境变量、具备可用额度的 Pro 账户。步骤一用 curl 向 https://public-api.gamma.app/v1.0/generations 发送 POST 请求,请求头包含 X-API-KEY 与 Content-Type,请求体含 content 和 outputFormat,用 jq 提取 generationId。步骤二每 5 秒轮询 GET /v1.0/generations/{generationId},读取 status 字段,completed 或 failed 时停止。步骤三从结果中提取 gammaUrl、exportUrl 与 creditsUsed。示例同时提供 curl、Node.js/TypeScript 和 Python 三种实现。
适用场景:新建可丢弃的 staging 演示文稿(使用虚构内容),确认仅面向获批的测试受众可见,然后通过文档化的清理路径删除或取消发布。
限制:所有生成均为异步,需轮询;轮询超时通常因生成量过大,可将轮询时长延长至 2 分钟以上;status 为 failed 时可简化内容或减少卡片数量。常见错误:POST 返回 401 表示 API 密钥错误,需核对 X-API-KEY 请求头;422 表示参数无效,需检查 content 与 outputFormat 取值。关于具体计费、价格与实际效果,资料暂未提供。