用途：帮助开发者为 Gamma Generate API v1.0（2025年11月起正式可用）配置身份认证，并完成首次连接验证。
主要能力：生成与管理 API Key、配置 X-API-KEY 请求头、通过环境变量保存密钥、用 curl 或 Node.js/Python 代码验证连接并调用主题与文件夹接口，同时给出密钥安全与错误处理建议。Gamma 使用 REST 接口 https://public-api.gamma.app/v1.0/，没有官方 SDK，所有请求通过 X-API-KEY 头认证。
前置条件：Gamma Pro 或更高账户（API 访问需 Pro+）、Node.js 18+ 或 Python 3.10+、curl 或 HTTP 客户端。
使用方式：在 gamma.app 的 Settings and Members 中选择 API key 标签创建密钥并安全保存；用 export GAMMA_API_KEY="gma_your_api_key_here" 或写入 .env；用 curl 请求 /themes 验证，返回 200 表示认证成功、401 表示密钥无效。Node.js 可封装 createGammaClient 调用 listThemes、listFolders；Python 可用 requests 携带 X-API-KEY 头访问。
适用场景：在开发、预发布、生产环境中分别配置独立密钥，初始化 REST API 访问并做只读验证。
限制与注意：API Key 仅显示一次；不要使用 Authorization: Bearer，必须用 X-API-KEY；v0.2 已于 2026 年 1 月废弃，仅用 v1.0；403 表示账户不在 Pro+ 计划；429 为限流需退避；API 调用按图像模型档位消耗积分（Standard 2-15、Advanced 20-33、Premium 34-75、Ultra 30-125 积分/图）。密钥不得提交到仓库，需定期轮换并按环境隔离。