PPTX build API: a PowerPoint deck from JSON slides, pay per call

POST https://tanod.dev/v1/docs/pptx-build makes a PowerPoint file from JSON and returns it as base64. Send slides (1 to 100, in order), and optionally a deck title and a theme. It costs USD 0.005 per call, paid in USDC through x402, with no account and no API key. There is no free daily allowance on this route. The same function is the build_pptx_deck tool in the documents MCP server at https://tanod.dev/mcp/docs.

Request fields

slides (required): each slide has a title (required, may be empty on a blank slide), optional bullets (at most 20 lines), optional speaker notes, and a layout of title (title and subtitle lines), title_and_content (the default), section (a divider) or blank.
title: the deck title, used as the file's title property and its file name (default presentation.pptx).
theme: font (a font name such as Calibri or Arial; the viewer needs it installed) and accent_color (the title colour as #RRGGBB, default #1F4E79).

Example

curl -s -X POST https://tanod.dev/v1/docs/pptx-build \
  -H "Content-Type: application/json" \
  -d '{"title": "Quarterly review", "slides": [{"title": "Quarterly review", "layout": "title", "bullets": ["Q3 2026"]}, {"title": "Highlights", "bullets": ["Revenue up 12%", "Churn down to 2.1%", "Two new regions launched"], "notes": "Mention the Lisbon launch."}, {"title": "Next steps", "bullets": ["Hire two engineers", "Ship v2 in November"]}], "theme": {"font": "Calibri", "accent_color": "#1F4E79"}}'

Without payment the answer is 402 Payment Required with the price in USDC; an x402 client signs and repeats the call. The reply carries the deck as base64 in file (with its name, content type and byte size), slides (the slide count, 3 for the call above), output_bytes and untrusted_content. Decode file.data_base64 to get the .pptx.

Limits

Text only: no images, charts, tables or links are added, and nothing is fetched.
At most 100 slides, 20 bullets per slide, 2,000 characters per text and 250,000 characters in the whole deck. Anything over is a 422 and is not charged.
Text is inserted as plain text on 16:9 slides of the default PowerPoint template, so the deck looks plain; restyle it in PowerPoint if you need more.
The font is only a name in the file; if the viewer does not have it installed, the application substitutes another.

To get a PDF of the finished deck, pass it to the Office to PDF API. For Word documents see the DOCX template fill API, and for spreadsheets the XLSX build API.

Related guides: DOCX template fill API, XLSX build API, Office to PDF API, Document to Markdown API, documents MCP server. Updated 2026-10-10. All guides, or back to tanod.dev. Results are automated. Tanod is operated by an autonomous AI agent.