The Beautiful.ai API is a prompt-to-deck endpoint that turns text input into a complete, editable presentation.
Instead of returning a loose outline or slide draft, the API generates a work-ready deck you can open in Beautiful.ai, refine with your team, share via link, or export to PPTX or PDF.
For full API reference and advanced usage, see the developer docs:
https://docs.beautiful.ai/reference/createpresentation-1
Getting Started
The Beautiful.ai API is currently available via early access. Here’s how it works.
1. Authentication
Create (or obtain) a Beautiful.ai API key and include it in the Authorization header as a Bearer token.
Authorization: Bearer YOUR_API_KEY
If your API key is missing or invalid, the API will return a 401 Unauthorized error.
2. Make a Request
Send a POST request to:
https://beautiful.ai/api/v1/generatePresentation
Required JSON Body
prompt(required): Describe the presentation you want in natural languagethemeId(optional): Apply a theme (e.g.,"minimal")
Example request body:
{
"prompt": "A pitch deck for a seed-stage B2B SaaS startup selling HR software.",
"themeId": "minimal"
}
3. Successful Response
On success (200 OK), the API returns:
presentationIdstatustitleeditorUrl(edit the deck)playerUrl(view/share the deck)
You can open the editorUrl in Beautiful.ai to refine the presentation, collaborate with your team, or export to PPTX/PDF.
Example Requests
cURL
curl -X POST "https://beautiful.ai/api/v1/generatePresentation" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "A pitch deck for a seed-stage B2B SaaS startup selling HR software.",
"themeId": "minimal"
}'
JavaScript (fetch)
const res = await fetch("https://beautiful.ai/api/v1/generatePresentation", {
method: "POST",
headers: {
"Authorization": `Bearer ${BEAUTIFUL_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
prompt: "A quarterly business review for an enterprise customer, covering KPIs, wins, risks, and next steps.",
themeId: "minimal",
}),
});
if (!res.ok) {
const err = await res.json().catch(() => ({}));
throw new Error(`Request failed (${res.status}): ${err.message || res.statusText}`);
}
const data = await res.json();
console.log(data.editorUrl, data.playerUrl);
Python (requests)
import os
import requests
url = "https://beautiful.ai/api/v1/generatePresentation"
api_key = os.environ["BEAUTIFUL_API_KEY"]
payload = {
"prompt": "An internal roadmap update deck with milestones, timelines, and dependencies for the next 2 quarters.",
"themeId": "minimal",
}
resp = requests.post(
url,
headers={
"Authorization": f"Bearer {api_key}",
"Content-Type": "application/json",
},
json=payload,
timeout=60,
)
resp.raise_for_status()
data = resp.json()
print("Editor:", data["editorUrl"])
print("Player:", data["playerUrl"])
Error Handling
The API returns standard HTTP status codes:
| Status Code | Meaning |
|---|---|
| 400 | Bad request (missing or invalid fields) |
| 401 | Unauthorized (missing or invalid API key) |
| 403 | Forbidden (API access not enabled) |
| 429 | Rate limit exceeded |
| 500 | Server error |
We recommend handling non-200 responses gracefully and surfacing helpful messages in your application.
Not exactly what you had in mind?
We’re building this in the open. Tell us what you were hoping an API would unlock for you.
Comments
Use the Beautiful.ai API to automatically convert existing content into presentations. For example, turning meeting transcripts, documents, reports, or dashboard data into ready-to-use slides. mcdvoice This could help teams instantly generate meeting recaps, executive summaries, investor pitch decks, or weekly business review presentations without starting from scratch.
Beautiful.ai could become the presentation engine behind productivity tools, transforming everyday work into polished decks in seconds.
This presentation was generated using the Beautiful.ai API, leveraging its prompt-to-deck functionality to transform structured text into a fully editable slide deck. After generating and refining the content, we published additional related resources on our platform at summertime saga Mod APK for users interested in exploring more structured digital content and updates.
This presentation was generated using the Beautiful.ai API, leveraging its prompt-to-deck functionality to transform structured text into a fully editable slide deck. After generating and refining the content, we published additional related resources on our platform at national police clearance application for users interested in exploring more structured digital content and updates.
This article was helpful and easy to understand! I learned that you can export your presentation from Beautiful.ai directly into Google Slides if you have a Pro, Team, or Enterprise plan. I also found it useful that it tells you what steps to click and that some things like videos and animations won’t work after you export. This makes it clear what to expect when moving a presentation from Beautiful.ai to Google Slides. Great explanation for users! like international time checker
Redirecting (old URL?) then rejecting the API key just created.
curl -L -X POST "https://beautiful.ai/api/v1/generatePresentation" \
-H "Authorization: Bearer $BAI_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "A pitch deck for a seed-stage B2B SaaS startup selling HR software.",
"themeId": "minimal"
}'
{"name":"ApiError401","message":"Api key is required","code":"unauthorized","status":401}%
Excited to see Beautiful.ai offering an API! This could be a game-changer for automating presentation creation and integrating it with tools like Emailor AI Email Writer.
Cool, didn't know Beautiful.ai had an API now. Been looking for a way to plug this into our internal tooling.
Honestly the hardest part for us is always the integration side - some research (modsen-software.com/custom-software-development-services). Took the pressure off our devs completely.
This article was helpful and easy to understand! I learned that you can export your presentation from Beautiful.ai directly into Google Slides if you have a Pro, Team, or Enterprise plan. I also found it useful that it tells you what steps to click and that some things like videos and animations won’t work after you export. This makes it clear what to expect when moving a presentation from Beautiful.ai to Google Slides. Great explanation for users! like pdf
This is actually one of the more useful AI presentation APIs I’ve seen because it returns a fully editable deck instead of just slide text or JSON structure. We tested something similar internally and one thing that helped was validating prompts before sending requests, especially for longer pitch decks, otherwise the output could become too generic.
Another small tip for developers: handling async status checks and saving the editor/player URLs immediately makes integrations much smoother when multiple presentations are generated in batches.
For anyone building workflows around AI-generated business content and documentation, I found a few additional implementation ideas while researching related tools — leggi qui — especially around structuring prompts for more consistent deck quality.
This API is a great timesaver for developers. I'm currently testing how it handles automated JSON payloads from gaming data repositories to create instant setup slides.
I actually structured my asset data paths based on an open Android framework—you can check out how the files are optimized for this video game to see the layout. Aligning the payload properties this way makes handling errors much easier!
"This is easily one of the most practical AI presentation APIs I've come across, mainly because it delivers a fully editable deck rather than just raw slide text or JSON structures. When we tested a similar workflow internally, we found that pre-validating prompts was a game geometry dash subzero -changer—especially for longer pitch decks. Without that step, the generated content tends to become a bit too generic."
This looks much more practical than tools that only generate slide outlines. Having a complete editable presentation ready to refine can save a lot of time, especially for teams working on client pitches or reports. I've been exploring AI-powered productivity tools recently and came across daveshotchicknmenu while researching how different platforms simplify content creation and presentation workflows. The ability to export directly to PPTX or PDF is a nice bonus.
Please sign in to leave a comment.