> 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/api-reference/reference.md).

# Reference overview

All paths use this base shape:

```
{PERCEPTIS_API_BASE_URL}/api/v1/...
```

Set `PERCEPTIS_API_BASE_URL` to the API origin only, for example `https://app.perceptis.ai`.

| Page                                                         | Endpoint                               |
| ------------------------------------------------------------ | -------------------------------------- |
| [POST /api/v1/generate](/api-reference/post-generate.md)     | Start a generation job                 |
| [GET /api/v1/status/{job\_id}](/api-reference/get-status.md) | Poll job status and downloads          |
| [Key management](/api-reference/keys.md)                     | Create, store, rotate, and revoke keys |

For examples that make full requests, see the [single-slide quickstart](/perceptis-api-v1/quickstart-single-slide.md), [complete-deck quickstart](/perceptis-api-v1/quickstart-deck.md), and [example script](/perceptis-api-v1/examples.md).