Slide deck

A teaching slide deck from your topic, outline or material, as editable PowerPoint and PDF.

Price2 credits (20p) per deck
Typical time2 min to 10 min
Scopemedia:write
Runs asA background job

Try it

Run slide deck in the sandbox

No key and nothing to pay. The sandbox returns a realistic example in a couple of seconds; no AI runs and no data is kept.

Queued202 and a job id, straight away
ProcessingPoll, stream or wait for a webhook
SucceededResult and files on the job

Every AI request runs as a background job, so nothing times out.

Writes the deck with EduMark Slides: quick (6–12 slides) or deep (10–24 slides, researched and reviewed as a teacher would). Licensed stock pictures are used where they help and AI pictures are drawn where none fits; each AI picture drawn costs slides.image (up to the deck's picture budget, reserved up front, unused pictures are not charged). Saves slides.pptx, slides.pdf (choose with formats) and deck.json. Anything the planner could not support from your material is listed in notes.

Requires media:write. Costs 2 credits per deck. Send a unique Idempotency-Key; reuse it with the identical body when retrying. Returns 202 with a job: poll GET /jobs/{job_id}, stream GET /jobs/{job_id}/events, or use a signed webhook.

Slide deck

POST/v1/slides

Scope media:write

Headers

Slide deck: headers
Field	Details
`Idempotency-Key`	stringRequiredA unique key per new operation; reuse it with the identical body when retrying.
`EduMark-Version`	enumAPI version. Defaults to the latest.One of `2026-10-21`

Request body

Slide deck: request body
Field	Details
`topic`	string, optionalWhat the deck teaches.Up to 300 characters
`audience`	string, optionalUp to 300 characters
`objective`	string, optionalUp to 600 characters
`notes`	string, optionalAnything else the planner should know.Up to 2,000 characters
`outline`	string, optionalYour own outline. When given, the deck follows it.Up to 12,000 characters
`source_text`	string, optionalMaterial the facts must come from (up to 10,000 words).Up to 60,000 characters
`document`	FileReference or DocumentInput, optionalA PDF, DOCX or TXT the facts must come from.
`file_id`document.file_id	stringRequiredThe id returned by POST /v1/files, after POST /v1/files/{id}/complete reported ready.When sending FileReferencePattern `^file_[a-f0-9]{32}$`
`filename`document.filename	stringRequiredWhen sending DocumentInputUp to 200 characters
`base64`document.base64	stringRequiredWhen sending DocumentInputUp to 27,962,028 characters
`mime_type`document.mime_type	string, optionalWhen sending DocumentInputUp to 150 characters
`mode`	enumquick: 6–12 slides. deep: 10–24 slides, researched and reviewed.One of `quick`, `deep`Default `"quick"`
`slide_count`	integer, optional3 to 30
`theme`	enumOne of `classic`, `chalk`, `editorial`, `bold`, `bright`, `minimal`, `warm`, `contrast`Default `"classic"`
`accent`	string, optionalAccent colour as #RRGGBB.Pattern `^#[0-9A-Fa-f]{6}$`
`stock_pictures`	booleanUse licensed stock pictures where they help.Default `true`
`ai_pictures`	booleanDraw AI pictures where no stock picture fits (charged per picture drawn).Default `true`
`formats`	array of enum1 to 2 items
`speaker_notes`	booleanInclude speaker notes in the files.Default `true`

Responses

Status	Meaning
202	Successful Response
400	Request rejected. Inspect error.code and request_id; failed work is not billed.
401	Request rejected. Inspect error.code and request_id; failed work is not billed.
402	Request rejected. Inspect error.code and request_id; failed work is not billed.
403	Request rejected. Inspect error.code and request_id; failed work is not billed.
404	Request rejected. Inspect error.code and request_id; failed work is not billed.
409	Request rejected. Inspect error.code and request_id; failed work is not billed.
410	Request rejected. Inspect error.code and request_id; failed work is not billed.
413	Request rejected. Inspect error.code and request_id; failed work is not billed.
415	Request rejected. Inspect error.code and request_id; failed work is not billed.
422	Validation Error
429	Request rejected. Inspect error.code and request_id; failed work is not billed.
503	Request rejected. Inspect error.code and request_id; failed work is not billed.

Request

curl -X POST 'https://api.edumark.ai/v1/slides' \
  -H "Authorization: Bearer $EDUMARK_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
  "topic": "The water cycle",
  "audience": "Year 7 geography",
  "mode": "quick",
  "slide_count": 8
}'

# Then poll until the job finishes (wait poll_after_seconds between calls)
curl 'https://api.edumark.ai/v1/jobs/job_01JB7Q8M4X2V9R' \
  -H "Authorization: Bearer $EDUMARK_API_KEY"

Queued202 and a job id, straight away
ProcessingPoll, stream or wait for a webhook
SucceededResult and files on the job

Every AI request runs as a background job, so nothing times out.

Response 202JSON

{
  "id": "job_0123456789abcdef0123456789abcdef01234567",
  "product": "slides",
  "status": "queued",
  "poll_after_seconds": 2,
  "credits": 2,
  "result_available": false
}

Finished job: resultJSON

{
  "status": "completed",
  "title": "The water cycle",
  "mode": "quick",
  "slide_count": 3,
  "ai_pictures": 0,
  "formats": [
    "pptx",
    "pdf"
  ],
  "deck": {
    "format": "edumark-slides-deck",
    "version": 1,
    "title": "The water cycle",
    "brief": {
      "tier": "quick",
      "audience": "Year 7 geography",
      "language": "en-GB"
    },
    "theme": {
      "id": "classic"
    },
    "slides": [
      {
        "id": "sl-01-start",
        "layout": "title",
        "variant": "left",
        "content": {
          "title": "The water cycle",
          "subtitle": "How water moves around our planet"
        },
        "notes": "Ask the class where rain comes from before you start."
      },
      {
        "id": "sl-02-stages",
        "layout": "steps",
        "variant": "row",
        "content": {
          "title": "Four stages",
          "items": [
            {
              "title": "Evaporation",
              "body": "The sun heats water and it rises as vapour."
            },
            {
              "title": "Condensation",
              "body": "Vapour cools into droplets that form clouds."
            },
            {
              "title": "Precipitation",
              "body": "Droplets join and fall as rain, sleet or snow."
            },
            {
              "title": "Collection",
              "body": "Water gathers in rivers, lakes and seas."
            }
          ]
        },
        "facts": [
          {
            "text": "Evaporation is driven by energy from the sun.",
            "kind": "general"
          }
        ]
      },
      {
        "id": "sl-03-check",
        "layout": "choice",
        "variant": "quiz",
        "content": {
          "question": "Which stage forms clouds?",
          "options": [
            "Evaporation",
            "Condensation",
            "Collection"
          ],
          "answer": 1
        }
      }
    ],
    "pictures": [],
    "sources": []
  },
  "notes": [],
  "provenance": {
    "engine": "edumark_slides",
    "ai_generated": true,
    "sandbox": true
  }
}