QUICKROUTER / PRACTICAL WORKBOOKPresenton API异步生成
已真实生成两份本地请求草稿并校验事实;未提交Presenton API,未产生真实任务ID或模型输出。具体操作与命令
1. 选定一套API文档
python3 verify.py
2. 按受众构造两份请求
python3 request-builder.py
3. 对照schema再提交
curl --fail-with-body --request POST "$PRESENTON_BASE_URL/api/v1/ppt/presentation/generate/async" --header "Authorization: $PRESENTON_AUTHORIZATION_HEADER" --header "Content-Type: application/json" --data-binary @beginners-request.json
4. 限制轮询与重试
python3 poll-example.py --url "$PRESENTON_BASE_URL/api/v1/ppt/presentation/status/$TASK_ID" --success completed --failure error
5. 下载终态产物
仅在自己版本定义的成功终态出现时下载结果URL。下载路径和任务映射按受众分别保存;确认文件是PPTX而不是JSON错误页。
6. 验证两份演示的差异
python3 verify.py --pptx beginners.pptx
7. 留存请求与恢复点
保存两份请求、状态日志和实际文件。素材里只有可离线运行的请求构造器及人工参考,不包含真实模型结果;未执行API时不要把草稿说成批量任务成功。