canonical: https://jentic.com/apis/magicslides.app/magicslides

# Magicslides App MagicSlides API

Jentic publishes the only available OpenAPI specification for MagicSlides API, keeping it validated and agent-ready. MagicSlides is an AI presentation generator that turns text, summaries, topics or YouTube videos into professional slide decks in seconds and supports more than 100 languages. The public API exposes four POST endpoints, with /ppt-from-text as the current canonical generator and three deprecated variants kept for backward compatibility.

## For AI agents

Generate complete PowerPoint presentations from raw text, a topic, a summary or a YouTube URL through MagicSlides' four AI generation endpoints.

## Scope

Does not handle slide editing, real-time collaboration, or hosting of generated decks - use for one-shot AI generation of presentation files only.

## Capabilities

- Generate a full presentation from arbitrary input text via POST /ppt-from-text
- Produce a slide deck from a single topic line through the legacy /ppt_from_topic endpoint
- Convert a long-form summary into a deck via the legacy /ppt_from_summery endpoint
- Generate a slide deck from a YouTube video transcript through the legacy /ppt_from_youtube endpoint
- Produce decks in over 100 languages by setting the language field on the input payload

## Use cases

### Meeting Notes to Slide Deck

Convert long-form meeting notes or a written briefing into a presentation ready to share. POST /ppt-from-text accepts the source text, the desired number of slides and a target language, and returns the generated deck. Suitable for chiefs of staff, founders and product managers who need to brief stakeholders without spending an hour authoring slides manually.

Example prompt: POST /ppt-from-text with the meeting transcript and slide_count=10 to receive the rendered presentation

### YouTube Video to Presentation

Repackage a YouTube tutorial as an internal training deck. The legacy POST /ppt_from_youtube endpoint accepts a video URL and produces a slide summary suitable for handouts. Useful for L&D teams curating external content into structured internal courses without re-recording or transcribing manually.

Example prompt: POST /ppt_from_youtube with the training video's URL to receive a slide deck for the L&D library

### Sales Pitch Generator

Spin up a tailored sales pitch on demand from a topic line such as 'cybersecurity for healthcare CIOs'. POST /ppt_from_topic returns a topical deck without the seller needing to script every slide manually. Suitable for SDR teams and outbound campaigns where the cost of a custom deck per prospect would otherwise be prohibitive.

Example prompt: POST /ppt_from_topic with topic 'cybersecurity for healthcare CIOs' and language='en' to receive a tailored pitch deck

### AI Agent Slide Generation

Let an AI assistant produce a polished deck on demand inside a chat or workflow without holding the MagicSlides API key. Through Jentic the agent searches for the slide generation operation, loads the schema for /ppt-from-text, and executes with credentials brokered by the vault. Useful for executive assistants, content production agents and BI assistants that need a presentation as the final artefact.

Example prompt: Search Jentic for 'generate a presentation from text', load POST /ppt-from-text, and execute with the user's source notes and the requested slide count

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| POST | `/ppt-from-text` | Generate a presentation from input text |
| POST | `/ppt_from_topic` | Generate a presentation from a single topic (deprecated) |
| POST | `/ppt_from_summery` | Generate a presentation from a summary (deprecated) |
| POST | `/ppt_from_youtube` | Generate a presentation from a YouTube URL (deprecated) |

## Key resources

- **Presentations** — Generate slide decks from text, topic, summary or YouTube via four POST endpoints

## Why Jentic

- **Setup:** Wiring the MagicSlides API by hand means sending its API key on each POST and picking between the current text endpoint and the deprecated topic, summary, and YouTube endpoints yourself. Through Jentic you install once, import the MagicSlides API from the API Directory, store the key once, and your agent calls it.
- **Permission scoping:** You choose which MagicSlides operations the agent may call, so you can limit it to the current generate-from-text operation and leave out the deprecated topic, summary, and YouTube endpoints. The agent only reaches the operations in the set you allow.
- **Credential handling:** Your MagicSlides key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'generate a presentation from text' or 'convert a YouTube video to slides', and Jentic returns the matching MagicSlides operation with its input schema so the agent calls the right endpoint without reading docs.

## Related APIs

- **Gamma API** — AI presentation builder with rich web-native deck output
- **OpenAI API** — Generate the source text or outline that feeds /ppt-from-text
- **PDFMonkey API** — Convert generated decks into branded PDF handouts

## FAQ

### Why is there no official OpenAPI spec for MagicSlides API?

MagicSlides publishes a documentation page at magicslides.app/magicslides-api/docs but does not ship a curated OpenAPI specification. Jentic generates and maintains this spec so AI agents and developers can call MagicSlides via structured tooling. It is validated against the live API and kept up to date. Get started with Jentic One, the self-hosted execution layer.

### What authentication does the MagicSlides API use?

The API uses an API key passed in a request header (the apiKey scheme defined in the spec). Through Jentic the key is stored encrypted in your Jentic One instance, so an agent calls /ppt-from-text with a scoped token rather than handling the raw key.

### Which MagicSlides endpoint should I use today?

Use POST /ppt-from-text - it accepts arbitrary input text and is the current supported generator. The /ppt_from_topic, /ppt_from_summery and /ppt_from_youtube endpoints are still in the spec but are marked deprecated, so new integrations should default to /ppt-from-text and only fall back to the others when their specific behaviours are required.

### What are the rate limits for the MagicSlides API?

Per-endpoint rate limits are not declared in the OpenAPI spec; MagicSlides typically applies plan-tier ceilings tied to the API key. Check the plan attached to your key on magicslides.app for production volume planning.

### How do I generate a presentation from text through Jentic?

Run pip install jentic, search for 'generate a presentation from text', and Jentic surfaces POST /ppt-from-text with its input schema. Execute with the source text, slide count and language fields, and persist the returned deck or download URL.

### Can MagicSlides generate decks in languages other than English?

Yes. The API supports more than 100 languages - set the language field on the input payload to /ppt-from-text (or any of the legacy endpoints) and MagicSlides generates the deck in that language. The same generation endpoints are used regardless of language.

### Can I limit what my agent is allowed to do with the MagicSlides API?

Yes. Because Jentic One is self-hosted, you set the rules that decide which MagicSlides operations and credentials your agent can use, and it can only reach the operations you allow. For example, you can permit just the current generate-from-text operation (POST /ppt-from-text) and leave out the deprecated topic, summary, and YouTube endpoints. Your MagicSlides API key is stored encrypted by your own instance and injected at execution time, so the agent never handles the raw key.