Getting Started

Alai transforms how teams create presentations. Instead of spending hours in PowerPoint, describe what you need and get professionally designed slides in seconds. The Alai API brings this power to your applications. Generate presentations programmatically, integrate with your workflows, and automate slide creation at scale.

What You Can Build

Generate Presentations

Turn text, notes, or documents into complete slide decks with AI-powered design

Add & Edit Slides

Programmatically add new slides to existing presentations

Export Anywhere

Get shareable links, PDFs, or PowerPoint files

Extract Content

Get structured content and layout information from slides

How It Works

Get Your API Key

Submit Your Content

POST to /generations with your text content. You’ll receive a generation_id immediately.

Poll for Completion

Check GET /generations/{id} every few seconds until status is completed.

Access Your Presentation

Get shareable links, download PDFs, or export to PowerPoint from the response.

Quick Example

import requests
import time

API_KEY = "your_api_key"
BASE_URL = "https://slides-api.getalai.com/api/v1"

# 1. Generate presentation
response = requests.post(
    f"{BASE_URL}/generations",
    headers={"Authorization": f"Bearer {API_KEY}"},
    json={
        "input_text": "Q4 revenue grew 25%. Key wins: Enterprise deals and product launches.",
        "presentation_options": {"title": "Q4 Results", "slide_range": "6-10"},
        "export_formats": ["link", "pdf"]
    }
)
generation_id = response.json()["generation_id"]

# 2. Poll until complete
while True:
    status = requests.get(
        f"{BASE_URL}/generations/{generation_id}",
        headers={"Authorization": f"Bearer {API_KEY}"}
    ).json()

    if status["status"] == "completed":
        print(f"View: {status['formats']['link']['url']}")
        print(f"PDF: {status['formats']['pdf']['url']}")
        break
    elif status["status"] == "failed":
        raise Exception(status.get("error"))

    time.sleep(3)

Get Your API Key

Sign up at app.getalai.com
Click on your name in the left sidebar
Select “API” from the dropdown menu
Click “Add new API key” to generate your key
Copy and securely store your API key

Keep your API key secure and never share it publicly. Treat it like a password.

Authentication

All requests require a Bearer token in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Base URL:

https://slides-api.getalai.com/api/v1

Available Endpoints

Async Operations

These endpoints return a generation_id. Poll GET /generations/{id} until complete.

Endpoint	Method	Description
`/generations`	POST	Generate a presentation from text
`/presentations/{id}/slides`	POST	Add a slide to a presentation
`/presentations/{id}/exports`	POST	Export to PDF, PPT, or shareable link
`/presentations/{id}/transcripts`	POST	Extract slide content and layout

Synchronous Operations

These endpoints return results immediately.

Endpoint	Method	Description
`/ping`	GET	Verify your API key
`/generations/{id}`	GET	Check generation status
`/upload-images`	POST	Upload images for presentations
`/presentations/{id}/slides/{slide_id}`	DELETE	Delete a slide
`/presentations/{id}`	DELETE	Delete a presentation

Generation Status

When polling, you’ll see one of these status values:

Status	Description
`pending`	Queued, not yet started
`in_progress`	Currently processing
`completed`	Finished successfully
`failed`	Error occurred (check `error` field)

Poll every 5 seconds. Most generations complete within 1-3 minutes depending on slide count.

Available Themes

Choose from 12 professionally designed themes:

Theme	Style
`AMETHYST_LIGHT`	Light purple, modern (default)
`NEBULA_DARK`	Dark blue, professional
`FLAT_WHITE`	Clean, minimalist
`DESERT_BLOOM`	Warm, earthy tones
`LAPIS_DAWN`	Blue gradient, corporate
`EMERALD_FOREST`	Green, natural
`COSMIC_THREAD`	Dark, cosmic
`DONUT`	Playful, colorful
`OAK`	Warm wood tones
`OBSIDIAN_FLOW`	Dark, sleek
`MIDNIGHT_EMBER`	Dark with red accents
`AURORA_FLUX`	Gradient, dynamic

Rate Limits

Max 5 concurrent generations per user
Recommended polling interval: 5 seconds

Need higher rate limits? Reach out to the Alai team at [email protected].

Credits

API generations consume the same credits as the Alai app. To check your balance or purchase more credits:

Go to Settings in your Alai account
Or contact [email protected] for enterprise plans

Error Handling

Code	Description
`200`	Success
`400`	Bad Request - Invalid parameters
`401`	Unauthorized - Invalid or missing API key
`402`	Payment Required - Insufficient credits
`404`	Not Found - Resource doesn’t exist
`422`	Validation Error - Check request body
`429`	Rate limit exceeded
`500`	Internal Server Error

Error responses include details:

{
  "message": "Error description",
  "status_code": 400
}

Alai API (Beta)

What You Can Build

Generate Presentations

Add & Edit Slides

Export Anywhere

Extract Content

How It Works

Quick Example

Get Your API Key

Authentication

Available Endpoints

Async Operations

Synchronous Operations

Generation Status

Available Themes

Rate Limits

Credits

Error Handling

Next Steps

Examples & Use Cases

Generate Presentation

Alai API (Beta)

​What You Can Build

Generate Presentations

Add & Edit Slides

Export Anywhere

Extract Content

​How It Works

​Quick Example

​Get Your API Key

​Authentication

​Available Endpoints

​Async Operations

​Synchronous Operations

​Generation Status

​Available Themes

​Rate Limits

​Credits

​Error Handling

​Next Steps

Examples & Use Cases

Generate Presentation

What You Can Build

How It Works

Quick Example

Get Your API Key

Authentication

Available Endpoints

Async Operations

Synchronous Operations

Generation Status

Available Themes

Rate Limits

Credits

Error Handling

Next Steps