Extract Transcripts

Extract slide content and layout information using AI. This is an async operation.

Returns a structured description of each slide’s text content and layout. You can process all slides or specify particular slide IDs.

POST /api/v1/presentations/{presentation_id}/transcripts

Generate slide transcripts

cURL

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>"
  ]
}
'

200

{
  "generation_id": "<string>"
}

Extract structured content and layout information from slides. This is an async operation.

Path Parameters

Parameter	Type	Description
presentation_id	string	ID of the presentation

---

Request Body

Parameter	Type	Default	Description
slide_ids	array	(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

200

application/json

Successful Response

generation_id · string · required

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