# 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)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.perceptis.ai/perceptis-api-v1/public-api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.