Skip to main content
Choose your deployment once. The selected tab contains its complete workflow, diagrams, numbered API sequences, and reference links.
Keep every call in a workflow on one deployment. Files, template identifiers, task IDs, and presentation IDs belong to the deployment that created them.
Presenton hosts Cloud v3 at https://api.presenton.ai/api/v3. Authenticate every request with a Cloud bearer token.

​
Cloud generation map

  1. Optional — upload source material: call Upload source files, then keep the returned file values.
  2. Optional — select a visual system: call List Standard templates or List Smart Designs.
  3. Optional — approve the narrative: call Generate an outline before building the deck.
  4. Generate: call Generate synchronously or Generate asynchronously.
  5. Resolve background work: process a subscribed webhook or call Get task status.
  6. Deliver: review the returned edit path, then call Export a presentation when a new PPTX or PDF is required.

​
Choose a Cloud workflow

​
Flow 1: Generate directly

Use direct generation when the prompt contains enough context and no source upload is required.
  1. Optional: Generate an outline and review the returned slide plan.
  2. Generate: Generate synchronously for an interactive request or use asynchronous generation.
  3. Optional: Export the presentation after review or editing.

​
Flow 2: Generate from source files

  1. Upload: call Upload source files.
  2. Generate: pass the returned values in files to Generate a presentation.
  3. Verify: compare names, dates, claims, calculations, and charts with the original sources.
  4. Deliver: call Export a presentation when the reviewed result needs another format.

​
Flow 3: Generate with a Cloud design

​
Standard template sequence

  1. List Standard templates.
  2. Optionally inspect the selected template.
  3. Call Generate a presentation with its ID in standard_template.

​
Smart Design sequence

  1. List Smart Designs.
  2. Call Generate a presentation with its ID in smart_design.

​
Flow 4: Import a PPTX template, then generate

Template creation happens in the Presenton application in this documented public workflow.
  1. Follow the custom PPTX template workflow.
  2. List Standard templates and keep the saved template ID.
  3. Generate a presentation with that ID in standard_template.

​
Flow 5: Create from structured JSON

Use structured JSON when the application owns the exact slide data and needs deterministic layout selection.
  1. List Standard templates.
  2. Get the selected template and inspect each layout’s json_schema.
  3. Optionally view a template example.
  4. Validate every slide object against its selected layout.
  5. Call Create from JSON synchronously or Create from JSON asynchronously.
  6. For background work, call Get task status.

​
Flow 6: Run Cloud jobs asynchronously

  1. Optional: Subscribe a webhook.
  2. Submit: Generate asynchronously.
  3. Store: persist the returned task ID before starting other work.
  4. Resolve: process the webhook idempotently or call Get task status with bounded backoff.

Cloud API quickstart

Review the shortest complete Cloud request chain.

Cloud authentication

Prepare and protect the bearer token.

Cloud generation reference

Inspect exact fields, schemas, and examples.