> For the complete documentation index, see [llms.txt](https://docs.perceptis.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.perceptis.ai/perceptis-api-v1/public-api.md).

# Overview

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](/perceptis-api-v1/infra-routing-and-env.md) 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](/perceptis-api-v1/authentication.md)
* [Quickstart: single slide](/perceptis-api-v1/quickstart-single-slide.md)
* [Quickstart: complete deck](/perceptis-api-v1/quickstart-deck.md)
* [API reference](/api-reference/reference.md)