--- title: "Presentation Agent API | Plus AI" description: "The Plus AI Presentation Agent API — a PowerPoint API that generates PowerPoint from a prompt or your data and edits existing PPTX programmatically. A versioned REST API returning native PPTX, PDF, and thumbnail files — async, with webhooks." canonical: "https://plusai.com/zh/features/presentation-agent-api/" --- Plus AI Presentation Agent API # Generate presentations with a single API call Send a prompt and the Presentation Agent plans, writes, and designs a finished deck — returned as native PowerPoint, PDF, and a thumbnail. Build deck generation into your product, pipeline, or workflow with the Plus AI PowerPoint API. [使用 Google 注册](https://app.plusdocs.com/preinstall?idp=Google)[ 使用 Microsoft 注册](https://app.plusdocs.com/preinstall?idp=Microsoft) - 3 outputs PPTX, PDF, and thumbnail every run - Webhooks Or poll — your call - Edit or create Start from a prompt or your own deck ## One endpoint, many jobs - ### Generate from a prompt Describe the deck you want — say, a 10-slide product overview — and generate PowerPoint from that prompt, every slide designed into an editable .pptx. - ### Edit an existing deck Edit an existing PPTX via the API — pass a .pptx and the agent revises, extends, or restyles it in place, like refreshing last quarter's board deck with this quarter's story, on brand. - ### Fill templates with data Attach a spreadsheet and the agent writes your numbers and charts into a template — like a monthly sales review built straight from your CRM export. - ### Turn documents into slides This document-to-PowerPoint API takes a PDF, doc, or call transcript and gives a structured deck back — turn a research report into a board-ready readout in one call. - ### Translate and localize Generate or convert a deck into any language, so a single source deck ships to every region without a rebuild. - ### Refresh on a schedule Re-run the same job every week or month to keep a recurring report current — wire it into a cron and stop rebuilding it by hand. How it works ## From API key to finished deck in four steps 1. 1 ### Upload your files PUT your template and any data or source files (up to 125 MB each) and get back a fileId for each. 2. 2 ### Create a session POST a prompt to /agent/sessions — optionally with your template and attachments. You get a sessionId and polling URL right away. 3. 3 ### Poll or get a webhook Check the session until its status is DONE, or pass a callbackUrl and let the agent notify you the moment it finishes. 4. 4 ### Download the results Grab the finished pptxUrl, pdfUrl, and thumbnailUrl — ready to deliver, store, or embed. Quickstart ## A finished deck in two requests Authenticate with a bearer token, create a session, then poll for the result. 1 · Create a session bash ``` curl -X POST "https://api.plusdocs.com/r/v0/agent/sessions" \ -H "Authorization: Bearer $PLUSAI_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "prompt": "Create a 12-slide investor update from the attached metrics.", "pptxFileId": "file_abc123", "attachments": [{ "fileId": "file_def456" }], "callbackUrl": "https://example.com/hooks/plus-ai" }' ``` Response json ``` { "sessionId": "sess_9f2c1a", "pollingUrl": "https://api.plusdocs.com/r/v0/agent/sessions/sess_9f2c1a" } ``` 2 · Poll for the result bash ``` curl "https://api.plusdocs.com/r/v0/agent/sessions/sess_9f2c1a" \ -H "Authorization: Bearer $PLUSAI_API_KEY" ``` Result json ``` { "status": "DONE", "pptxUrl": "https://files.plusdocs.com/o/investor-update.pptx", "pdfUrl": "https://files.plusdocs.com/o/investor-update.pdf", "thumbnailUrl": "https://files.plusdocs.com/o/investor-update.png" } ``` [Read the full API docs](https://guide.plusai.com/apis-for-presentations/presentation-agent-api) From data to decks ## Fill templates with your data Keep a deck as a reusable template and let the agent populate it from your data — preserving layout and branding, every time. - ### Data-driven decks Generate PowerPoint from your data — attach a CSV, Excel spreadsheet, JSON, or document and the agent writes the numbers, charts, and commentary straight into your template. - ### A deck for every customer Bulk generate presentations with the API — loop over your rows, one call per customer, region, or rep, to produce a personalized deck for each from the same template. - ### Scheduled refreshes Run it on a cron to refresh a weekly report or board deck with the latest figures — hands-free. Built for developers ## Production-grade from the first request - ### Async by default Kick off a job and get a sessionId instantly. Nothing blocks while the agent works. - ### Webhooks, not waiting Pass a callbackUrl and get notified on every state change — HTTPS-only, with SSRF protection built in. - ### Bring your own content Attach spreadsheets, documents, and images so the agent grounds each deck in your real data. - ### Clean REST surface A versioned /r/v0 API with an OpenAPI 3.1 spec and conventional HTTP status codes. - ### Any language Generate or translate presentations in any language — set it per session or let the agent auto-detect. - ### Org-scoped and metered Every file and session is scoped to your organization, with clear credit accounting and typed errors. Real files, no lock-in ## Native PowerPoint out, every time Each session returns a real, editable .pptx you can open in PowerPoint or Google Slides — plus a PDF and a thumbnail. The PowerPoint API hands back native files, so the decks you generate are yours to keep. - ![Microsoft PowerPoint](https://plusai.com/images/logos/powerpoint.svg) - ![Google Slides](https://plusai.com/images/logos/google-slides.svg) ## Build it into your stack - ### Call it from anywhere It's just REST over HTTPS with a bearer token and an OpenAPI spec — call it from any language or framework. - ### Automation platforms Trigger decks from the tools you already use with Zapier, n8n, or Make — no backend required. - [ ### MCP and agents Pair this AI presentation agent with the Plus AI presentation MCP server to let your own agents generate slides as a tool. ](https://plusai.com/zh/features/mcp) [Explore the MCP server](https://plusai.com/zh/features/mcp) ## Developer FAQ ### How do I authenticate? Every request sends an `Authorization: Bearer $PLUSAI_API_KEY` header. API access is included on Pro and Team plans — generate a key from your Plus AI account. ### Is it synchronous or asynchronous? Asynchronous. Creating a session returns immediately with a `sessionId` and a `pollingUrl`. Poll `GET /agent/sessions/{id}` until the status is `DONE`, or pass a `callbackUrl` to receive a webhook on every state change. ### Can I edit an existing presentation? Yes. Upload a .pptx, pass its `pptxFileId` when you create the session, and edit that PowerPoint programmatically — the agent revises, extends, restyles, or translates it in place while preserving your layout and branding. ### How do I fill a template with data? Upload your template and your data export (CSV, XLSX, JSON, or a document), reference both when you create the session, and the agent writes the figures, charts, and copy into the deck. To bulk generate personalized decks, call the API once per record. ### What comes back, and how big can files be? Each finished session exposes a `pptxUrl`, a `pdfUrl`, and a `thumbnailUrl`. Files can be up to 125 MB on the way in. ### How is usage billed? Sessions draw from your plan's AI agent credits. If you run out, the API returns a typed `402 INSUFFICIENT_AGENT_CREDITS` so you can handle it gracefully. ### Is my data isolated? Every file and session is scoped to your organization. Callback URLs must be public HTTPS endpoints — localhost and private addresses are rejected to prevent SSRF. Built for teams and enterprises ## Plans that scale from prototype to production API access is included on Pro and Team plans — with more control as you scale ### Plus AI 团队版 - API access on Pro and Team plans - Async sessions with webhook callbacks - Custom templates, brand kit, and shared presets [开始免费试用](https://app.plusdocs.com/preinstall) ### 企业 - Volume credits and higher usage limits - 全程托管的模板转换服务 - SSO, user management, and white-glove onboarding [预约演示](https://plusai.com/zh/contact-enterprise) ## Trusted by teams building with Plus AI. - ![Notion](https://plusai.com/images/logos/notion.svg) - ![Zapier](https://plusai.com/images/logos/zapier.svg) - ![Unity](https://plusai.com/images/logos/unity.svg) - ![Qualtrics](https://plusai.com/images/logos/qualtrics.svg) - ![Vimeo](https://plusai.com/images/logos/vimeo.svg) - ![Stripe](https://plusai.com/images/logos/stripe.svg) - ![Asana](https://plusai.com/images/logos/asana.svg) - ![Atlassian](https://plusai.com/images/logos/atlassian.svg) - ![Canva](https://plusai.com/images/logos/canva.svg) - ![Deloitte](https://plusai.com/images/logos/deloitte.svg) - ![Salesforce](https://plusai.com/images/logos/salesforce.svg) - ![Google](https://plusai.com/images/logos/google.svg) - ![Flexport](https://plusai.com/images/logos/flexport.svg) - ![Uber](https://plusai.com/images/logos/uber.svg) - ![1Password](https://plusai.com/images/logos/1password.svg) - ![Houzz](https://plusai.com/images/logos/houzz.svg) - ![Shipium](https://plusai.com/images/logos/shipium.svg) - ![Airtable](https://plusai.com/images/logos/airtable.svg) - ![Nvidia](https://plusai.com/images/logos/nvidia.svg) ## What teams say about Plus AI - > 就 Google Slides 而言，这无疑是市面上最好的 AI 演示文稿制作工具。我可以根据提示词生成完整的演示文稿，也可以把文本转换成幻灯片。 ![Photo of 埃弗雷特·西兹摩尔 ](https://plusai.com/images/avatars/everett.png) 埃弗雷特·西兹摩尔 - > 我对“Remix”功能印象尤其深刻，它能把现有幻灯片重新排版成新的版式。我很喜欢这个功能，干得漂亮👍 ![Photo of 史蒂芬·尹恩 ](https://plusai.com/images/avatars/helen.png) 史蒂芬·尹恩 - > Plus AI 为我的演示文稿搭建了出色的结构和要点。我很喜欢每张幻灯片上的提示，帮我挑选图片或展开论述。这个工具现在是我的得力助手！ ![Photo of 凯特·默里 ](https://plusai.com/images/avatars/katmurray.jpg) 凯特·默里 - > 与 Google Slides 的集成非常顺畅。感觉就像本就该一直存在一样！总体五星好评。 ![Photo of 阿维克·李 ](https://plusai.com/images/avatars/avatar-generic.png) 阿维克·李 - > 这是一款出色的工具，为我节省了大量时间。配合详细的提示词，它生成的演示文稿只需稍作修改。我们团队很喜欢用它做头脑风暴，客户经理也用它与客户协作。 ![Photo of 格温内特作家辛克莱 ](https://plusai.com/images/avatars/gwenette.png) 格温内特作家辛克莱 - > 它真的帮我理清了大纲，对于一场临近截止的演示来说，既省时又救急。我喜欢它可以在 Google Slides 中使用——反正我本来就用它来做演示！ ![Photo of 托比亚斯·舒尔茨 ](https://plusai.com/images/avatars/tobias.png) 托比亚斯·舒尔茨 - > 我几乎试遍了市面上适用于 Google Slides 和 PPT 的 AI 幻灯片生成工具。这一款无疑是最好的——它就是好用。 ![Photo of Ritchie Wong](https://plusai.com/images/avatars/ritchie.png) Ritchie Wong - > 与 PowerPoint 的集成正是这款产品如此实用的原因。我每周都要制作大量演示文稿，做 PowerPoint 时我首先想到的就是 Plus AI。 ![Photo of 安东尼奥· ](https://plusai.com/images/avatars/tracy.png) 安东尼奥· ## Start building with the Presentation Agent API. Generate an API key on any Pro or Team plan and ship your first deck today. [免费开始](https://app.plusdocs.com/preinstall)