用途:调用 Gamma 的 Generate API(POST /v1.0/generations)根据文本提示生成演示文稿、文档、网页与社交帖子,可控制输出格式、文本模式与数量、主题、图像风格、分享权限、文件夹归属及导出格式。使用前提为已完成 gamma-sdk-patterns、拥有含可用积分的 Pro 账户,工作区主题可选配置。主要能力:outputFormat 支持 presentation、document、webpage、social_post;textMode 支持 generate(AI 扩写)、condense(压缩)、preserve(保留原文);textAmount 支持 brief、medium、detailed、extensive;themeId 来自 GET /v1.0/themes,folderIds 来自 GET /v1.0/folders;imageOptions.style 可填自由文本描述图像风格;exportAs 支持 pdf、pptx、png;sharingOptions 控制 workspaceAccess 与 externalAccess。使用方式:用 createGammaClient 创建客户端后调用 gamma.generate() 获取 generationId,再通过 pollUntilDone 轮询至完成,读取 gammaUrl、exportUrl、creditsUsed;也可直接用 curl 请求,头信息为 X-API-KEY 与 Content-Type: application/json。批量生成时可用 p-limit 限制并发(示例为 3)。积分方面,标准图像约 2-15 积分/张,进阶 20-33,高级 34-75,超高级 30-125;10 卡含 5 张标准图像大约 20-60 积分。常见错误包括 422 参数组合无效、status 为 failed(内容过复杂)、429 并发过多、exportUrl 为空(未指定 exportAs)。限制:具体用量与积分以实际账户为准;本地图像与主题需先查询获得,工作区默认值在未显式指定时生效。未提供的细节未在资料中说明。
gamma-core-workflow-a
办公与效率
更新于 10-15 23:26