
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
Sign up at app.getalai.com and generate an API key from your account settings.
Submit Your Content
POST to
/generations with your text content. You’ll receive a generation_id immediately.Quick Example
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
Authentication
All requests require a Bearer token in theAuthorization header:
Available Endpoints
Async Operations
These endpoints return ageneration_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) |
Available Themes
Choose from 23 professionally designed themes:| Theme | Style |
|---|---|
Simple Light | Clean, minimal light theme (default) |
Simple Dark | Clean, minimal dark theme |
Simple Light (with color) | Light theme with color accents |
Simple Light (Serif) | Light theme with serif typography |
Simple Dark (Serif) | Dark theme with serif typography |
Fairytale | Whimsical, storybook aesthetic |
Techy Grey | Modern, tech-inspired grey tones |
Classic Maroon | Elegant, classic maroon palette |
Royal Blue | Bold, royal blue styling |
Retro blue | Vintage-inspired blue design |
Dark Cool Serif | Dark theme with cool-toned serif fonts |
Light Cool Creative | Light, creative layout with cool tones |
Dark Serif Warm | Dark theme with warm serif typography |
Dark Creative Warm | Dark, creative layout with warm tones |
Red & Paper | Red accents on paper-textured background |
Donut | Playful, colorful |
Cyberpunk | Neon-lit, futuristic aesthetic |
Aurora Flux | Gradient, dynamic |
Oak | Warm wood tones |
Emerald Forest | Green, natural |
Midnight Ember | Dark with red accents |
Prismatica | Prismatic, multi-color design |
Desert Bloom | Warm, earthy tones |
Rate Limits
- Max 5 concurrent generations per user
- Recommended polling interval: 5 seconds
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 founders@getalai.com 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 |