Playground - Alai Docs

Using the Playground

The request body accepts a JSON object containing all your generation options.

Only input_text is required. All other options have sensible defaults, so you can start simple and add customization as needed.

Authorizations

Authorization

string

header

required

API key passed as Bearer token

Body

application/json

input_text

string

required

The main content that drives your presentation generation. This text forms the foundation of all slides created.

Example:

"Quarterly sales increased 25% YoY. Key drivers: enterprise segment growth, new product launches, expanded market reach."

additional_instructions

string

default:""

Custom generation instructions for AI that fine-tune how content is delivered on the presentation.

Example:

"Make it infographic"

presentation_options

object

Options for presentation appearance and structure

Show child attributes

presentation_options.title

string

Sets the title displayed in your presentation.

Example:

"Q4 2024 Sales Report"

presentation_options.theme_id

enum<string>

default:AMETHYST_LIGHT

Defines which theme from Alai will be used for presentation.

Available options:

NEBULA_DARK,

AMETHYST_LIGHT,

FLAT_WHITE,

DESERT_BLOOM,

LAPIS_DAWN,

EMERALD_FOREST,

COSMIC_THREAD,

DONUT,

OAK,

OBSIDIAN_FLOW,

MIDNIGHT_EMBER,

AURORA_FLUX

Example:

"AMETHYST_LIGHT"

presentation_options.slide_range

enum<string>

default:6-10

Controls the target number of slides generated from your content.

Available options:

auto,

1,

2-5,

6-10,

11-15,

16-20,

21-25

Example:

"6-10"

presentation_options.choices_per_slide

enum<integer>

default:1

The number of slide variants to generate per slide (1-4).

Available options:

1,

2,

3,

4

Example:

1

presentation_options.export_as

enum<string>

default:link

Controls the response format. link waits for completion and returns the presentation URL. id returns immediately with the presentation ID while generation continues in background. pdf waits for completion and returns the presentation as a PDF file.

Available options:

link,

id,

pdf

Example:

"link"

text_options

object

Options for text content generation

Show child attributes

text_options.language

enum<string>

default:English (US)

Specifies the language for generated content and AI-generated elements.

Available options:

English (US),

English (UK),

Spanish (Latin America),

Spanish (Mexico),

Spanish (Spain),

French,

German,

Italian,

Portuguese (Brazil),

Portuguese (Portugal),

Dutch,

Polish,

Russian,

Japanese,

Korean,

Chinese (Simplified),

Hindi,

Swedish,

Norwegian,

Danish,

Finnish,

Greek,

Turkish,

Czech,

Hungarian,

Romanian,

Bulgarian,

Ukrainian,

Vietnamese,

Thai,

Indonesian

Example:

"English (US)"

text_options.tone

enum<string>

default:PROFESSIONAL

Defines the writing voice, style, and perspective applied to generated content.

Available options:

DEFAULT,

PROFESSIONAL,

CASUAL,

TECHNICAL,

EDUCATIONAL,

INSPIRATIONAL,

NARRATIVE,

PERSUASIVE,

AUTHORITATIVE,

EMPATHETIC,

CUSTOM

Example:

"PROFESSIONAL"

text_options.tone_instructions

string

Custom tone directives when no preset tone matches your needs. Set only when tone is CUSTOM.

text_options.content_mode

enum<string>

default:preserve

Controls how input text is processed and adapted for presentation format.

Available options:

preserve,

enhance,

condense,

custom

Example:

"preserve"

text_options.content_instructions

string

Custom directives for text processing when no preset mode fits. Set only when content_mode is custom.

text_options.amount_mode

enum<string>

default:essential

Controls the density of text appearing on each slide.

Available options:

minimal,

essential,

balanced,

detailed,

custom

Example:

"essential"

text_options.amount_instructions

string

Custom text density directives for specialized requirements. Set only when amount_mode is custom.

image_options

object

Options for AI-generated images

Show child attributes

image_options.include_ai_images

enum<string>

default:true

Whether to generate AI-powered illustrations alongside your content.

Available options:

true,

false

Example:

"true"

image_options.style

enum<string>

default:auto

Controls the visual style of AI-generated images.

Available options:

auto,

realistic,

artistic,

cartoon,

three_d,

custom

Example:

"auto"

image_options.style_instructions

string

Custom image generation directives for specialized visual requirements. Set only when style is custom.

Response

Presentation generated successfully

presentation_url

string<uri>

required

Direct URL to view the generated presentation

Example:

"https://app.getalai.com/presentation/<uuid>"

presentation_id

string<uuid>

required

Unique identifier for the presentation

Example:

"<uuid>"

Alai API (Beta)

​Using the Playground

Authorizations

Body

Response

Using the Playground