PPT美化查询任务
更新时间：2026-06-18
GET
https://qianfan.baidubce.com/v2/tools/ppt_beautify_query
PPT美化查询任务接口，通过任务ID（task_id）查询PPT美化状态以及PPT美化后的文件url。
权限说明
调用本文API，需使用API Key鉴权方式。使用API Key鉴权调用API流程，具体调用流程，请查看认证鉴权。
请求参数
Headers 参数
除公共头域外，无其它特殊头域
Body 参数
task_id
string
创建任务时返回的任务id（ task_id）
必选
示例代码
请求示例
curl --request GET \
--url https://qianfan.baidubce.com/v2/tools/ppt_beautify_query?task_id=1c440d02-f79d-4da4-9293-19cf4ed561b5 \
--header 'Authorization: Bearer xxxxxx' \
--header 'content-type: application/json'返回响应
Headers 参数
除公共头域外，无其它特殊头域
返回参数
code
string
错误码，成功：0
可选
message
string
状态描述
可选
requestId
string
请求唯一ID
可选
status
string
任务状态：running（运行中） / finished（成功） / failed（失败）
可选
pptx_url
string
美化后的 PPT 下载链接（仅 status=finished 时有值）；备注：返回的 pptx_url 为带签名的临时下载链接，有效期 24 小时
可选
retry_count
string
已重试次数
可选
响应示例
{
"pptx_url": "https://wkbjcloudbos.bdimg.com/v1/wangpan-ai-doc/netdisk-ai-mcp/html2pptx/2e679a1c-2a71-4b7c-af40-8c3ac187069b.pptx?responseContentType=application%2Fvnd.openxmlformats-officedocument.presentationml.presentation&responseCacheControl=max-age%3D1&responseExpires=Mon%2C%2008%20Jun%202026%2020%3A00%3A38%20%2B0800&authorization=bce-auth-v1%2F46dc8cc346744dad800651823a96d9cd%2F2026-06-08T12%3A00%3A37Z%2F86400%2Fhost%2F49f7f2d634e6950adfcea1edd2d2eb876fa372c8fea9dc9fcdc6332fccfb8402&token=eyJ0eXAiOiJKSVQiLCJ2ZXIiOiIxLjAiLCJhbGciOiJIUzI1NiIsImV4cCI6MTc4MTAwNjQzNywidXJpIjp0cnVlLCJwYXJhbXMiOlsicmVzcG9uc2VDb250ZW50VHlwZSIsInJlc3BvbnNlQ2FjaGVDb250cm9sIiwicmVzcG9uc2VFeHBpcmVzIl19.5t%2B6%2Bj6lLetIK4pR%2B6CkuKRgai863YZ1ZSOlAB4e4%2Fc%3D.1781006437",
"retry_count": 0,
"status": "finished"
"requestId": "",
"code": "0"
}错误码说明
| code | 描述 | 触发场景 |
|---|---|---|
| 0 | 成功 | 请求正常处理 |
| 40001 | 参数验证失败 | pptx_url 为空/格式非法，style_images 超过 20 张或 URL 非法，task_id 为空，appid为空 |
| 40003 | APPUID不能为空 | 未传 APP_UID 请求头 |
| 40004 | 任务不存在 | task_id 不存在，或 appid/APP_UID 与创建时不一致 |
| 50001 | PPTX 文件解析失败 | 源 PPT 文件无法解析 |
| 50002 | PPT 美化服务异常，请稍后重试 | AI Agent 调用失败 |
| 50003 | 文件转码失败，请稍后重试 | pptx2image 或 html2pptx 转码服务失败 |
| 50004 | 会话分配失败，请稍后重试 | ID 分配服务失败 |
| 50005 | 系统内部错误，请稍后重试 | 其他系统错误 |
| 50006 | 内容命中风控，无法处理 | 内容安全审核未通过 |
评价此篇文章