API 接入：密钥生成、基础地址与常见错误码
想把演示文稿生成嵌进自己的系统、或用自动化工具批量出稿，官方提供 REST API。本页是入门路径与避坑清单。
资格与开通
- 订阅门槛：Pro、Ultra、Teams 或 Business 档才含 API 访问；
- 生成密钥：设置和成员 → API 密钥标签 → 创建 API 密钥 → 复制保存。密钥只在生成时显示一次，丢了只能重新生成；
- 密钥格式为 sk-gamma- 开头，支持创建多个密钥区分项目。
调用要点
- 认证方式：密钥通过 X-API-KEY 请求头传递——不是 Bearer 令牌，用错认证头会得到 401；
- 基础地址：public-api-dot-gamma-app 系列域名的 v1.0 版本接口（完整地址见开发者文档）；
- 输入限制：单次生成最多 10 万代币（约 40 万字符）；
- 认证替代：支持 OAuth 2.0，适合不想管理静态密钥的集成场景。
v1.0 能做什么
- 生成演示文稿、文档、网页、社交帖；
- 生成独立图像（也可经 MCP 在 Claude 等客户端里调用）;
- 搜索你的文件库（标题与全文，逐步推出中）;
- 自定义页眉页脚、引用图片 URL、文件夹管理、邮件分享、列出主题与文件夹；
- 配合 Zapier、Make、n8n 等自动化平台做无代码工作流。
错误码速查
| 码 | 含义 | 处理 |
|---|---|---|
| 401 | 未授权 | 检查是否用 X-API-KEY 头、密钥是否有效 |
| 403 | 禁止 | 查积分余额，开启自动充值 |
| 429 | 限流 | 联系支持提容量 |
| 422 | 生成失败 | 检查输入参数 |
两个容易懵的行为
- API 生成的内容不在主列表里：去仪表板的"API 生成"区找；想让它进入常规列表，打开后点"复制"，副本按普通文件处理；
- 主题要预建：API 引用的主题必须先在界面里创建并拿到主题 ID，不能靠输入文本临时指定。
求助姿势
报障时附上：响应头里的 x-request-id、完整错误信息、请求体示例、所用自动化平台。官方可协助平台侧问题，不负责替你写业务代码或调试自定义应用。
API 能力迭代较快，参数与地址以官方开发者文档的最新版本为准。