Overview

Overview of Perceptis API v1.

The Perceptis API lets you generate PowerPoint slides and decks from your own systems. Submit a prompt, choose an output type and optional template, poll for completion, then download the generated .pptx file.

Overview

Generation is asynchronous:

1. Send POST /api/v1/generate with a prompt and output_type.

2. Receive a job_id.

3. Poll GET /api/v1/status/{job_id} with the same API key.

4. When status is completed, download the PowerPoint file from the downloads array.

The API supports:

• Single-slide generation with optional variants.

• Complete-deck generation.

• Template selection by name.

• Optional web search and knowledge base context.

• Reference images for single-slide generation.

• Idempotent generate requests for safe retries.

• Status polling with Retry-After guidance.

Who can use it

API access is available only on paid Business and Enterprise plans. Free, Starter, and trial organizations cannot create or use API keys.

Create and revoke API keys in Developer Settings in the Perceptis web app. Usage draws from your organization's credit pool.

Base URL

Use the API origin as your base URL:

https://app.perceptis.ai

All v1 examples use paths under:

{PERCEPTIS_API_BASE_URL}/api/v1/

Set PERCEPTIS_API_BASE_URL to the origin only, without a path. For example, use https://app.perceptis.ai, not https://app.perceptis.ai/api.

See Base URLs and environment for environment variable guidance.

Polling

Poll every few seconds, set an integration-level timeout, and respect 429 responses with the Retry-After header. Completed status responses include short-lived download URLs; poll status again for fresh links whenever needed. Job downloads are visible only to the API key that created the job.

Next steps

• Authentication

• Quickstart: single slide

• Quickstart: complete deck

• API reference