展开本页目录
开始前准备什么
- 准备自己有权使用的合成练习资料，不上传他人的录音或私密内容。
- 按官方文档核对当前平台、版本与套餐；本轮目标产品操作未执行，练习文件可离线查看。
- 冻结三页基线
- 核对API权限和凭据
- 提交单页编辑请求
- 保存响应再轮询
- 同页串行等待
- 比较目标与未选页
- 交付请求链和差异
1. 冻结三页基线
给封面、数量表、否定提醒各保存文字与哈希，标出唯一目标page-2。练习ID是占位，不伪装成可调用真实账号资源。
2. 核对API权限和凭据
按当前Pro等可用套餐创建测试环境，通过X-API-KEY使用密钥。密钥从安全环境读取，不写入下载材料或截图。
3. 提交单页编辑请求
使用POST /v1.0/agent/gammas/{gammaId}/edits指定现有gamma与单页约束。要求只改24到30并保留其他页，不把增加页面写进当前支持范围。
4. 保存响应再轮询
从真实响应取editId，再访问GET /v1.0/agent/edits/{editId}。保留x-request-id排错，不能把本地占位值改成completed模拟服务成功。
5. 同页串行等待
上一项未结束时不再对同一页发第二次写入。失败先保存错误和请求ID，复核参数后才决定重试，避免盲目重复写。
6. 比较目标与未选页
读取实际编辑后的内容，核对数量变更及封面、提醒页未变化。异步完成状态不自动证明内容正确。
7. 交付请求链和差异
保存脱敏请求、真实状态、前后数据差异与空白待填栏。根端作者PPTX仅提供可编辑基线，不当作API运行结果。
下载本课材料并开始操作
练习包包含本课的具体输入、可编辑数据、正反样例与七步说明。index.html 可离线查看原件和验收参考，actual-results.csv 用于记录你实际操作后的结果。
怎样确认已经完成
- 请求路径与轮询路径分开，响应真实editId只在实际返回后填写。
- 同一页不并发多个修改，未选两页内容哈希保持。
- API key不放练习PPTX，加入页面不是本接口已支持能力。
常见问题
Gamma编辑API返回的ID怎么查结果？
现有gamma编辑返回editId，使用对应agent/edits查询路径；它与生成任务ID不是同一概念。只有真实返回后才填写任务状态。
能同时对同一页发好几个修改吗？
当前官方限制每页一次编辑任务，应串行等待。完成后仍需核对实际内容和未选页面，不能只看异步状态。