Skip to main content
POST
Generate Presentation
Generate the initial Modern artifact using Alai’s agentic presentation workflow. The request returns 202 Accepted with an operation to poll. slide_count is exact when supplied. asset_ids must refer to assets uploaded to this presentation. Use a model ID returned by GET /models, or omit model to use the default.
Poll GET /operations/{operation_id} until the operation reaches succeeded or failed.

Authorizations

Authorization
string
header
required

Your Alai API key. Get one from your account settings at app.getalai.com

Path Parameters

presentation_id
string
required

Body

application/json
content
string
required
Required string length: 1 - 100000
instructions
string | null
Maximum string length: 10000
slide_count
integer | null
Required range: 1 <= x <= 50
asset_ids
string[]
Maximum array length: 20
model
ModernApiModelSelection · object | null
idempotency_key
string | null
Required string length: 1 - 128

Response

Successful Response

id
string
required
operation_type
enum<string>
required
Available options:
generate,
edit,
export
presentation_id
string
required
status
enum<string>
required
Available options:
queued,
running,
succeeded,
failed
progress
Progress · object | null
result
Result · object | null
error
string | null
created_at
string | null
started_at
string | null
completed_at
string | null