Skip to main content
POST
/
api
/
v1
/
presentations
/
{presentation_id}
/
transcripts
Generate slide transcripts
curl --request POST \
  --url https://slides-api.getalai.com/api/v1/presentations/{presentation_id}/transcripts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "slide_ids": [
    "<string>"
  ]
}
'
{
  "generation_id": "<string>"
}
Extract structured content and layout information from slides. This is an async operation.

​
Path Parameters

ParameterTypeDescription
presentation_idstringID of the presentation

​
Request Body

ParameterTypeDefaultDescription
slide_idsarray(all slides)Specific slide IDs to extract transcripts for. If omitted, extracts for all slides.

​
Response

{
  "generation_id": "abc123-def456-..."
}
Poll GET /generations/{generation_id} until status is completed.

​
Example

​
All Slides

curl -X POST "https://slides-api.getalai.com/api/v1/presentations/xyz789-.../transcripts" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

​
Specific Slides

curl -X POST "https://slides-api.getalai.com/api/v1/presentations/xyz789-.../transcripts" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "slide_ids": ["slide1-...", "slide2-..."]
  }'

​
Status Response

{
  "generation_id": "abc123-...",
  "generation_type": "transcript_generation",
  "status": "completed",
  "presentation_id": "xyz789-...",
  "transcripts": [
    {
      "slide_id": "slide1-...",
      "slide_order": 0,
      "title": "Q4 Sales Report",
      "content": "Quarterly Performance Overview\n\nRevenue: $1.2M\nGrowth: +25% YoY",
      "layout": "TITLE_SLIDE"
    },
    {
      "slide_id": "slide2-...",
      "slide_order": 1,
      "title": "Key Metrics",
      "content": "• New customers: 150\n• Retention rate: 94%\n• NPS score: 72",
      "layout": "CONTENT_SLIDE"
    }
  ]
}
Transcript generation uses credits. The cost is based on the number of slides processed.

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
​
slide_ids
string[] | null

Specific slides to generate transcripts for. If omitted, generates for all slides.

Response

Successful Response

​
generation_id
string
required

Unique identifier to poll for generation status via GET /generations/{generation_id}