> ## Documentation Index
> Fetch the complete documentation index at: https://docs.selektable.com/llms.txt
> Use this file to discover all available pages before exploring further.

# API introduction

> Generate AI product visualizations over a REST API

The Selektable API lets you generate AI product visualizations from a customer photo — **fashion** (`virtual-try-on`) and **interior** (`room-visualizer`) — over a REST API.

## Base URL

```
https://api.selektable.com/v1
```

## Conventions

* **Format:** JSON for requests and responses.
* **Auth:** API key as a Bearer token (see [Authentication](/api-reference/authentication)).
* **Delivery:** asynchronous — [webhooks](/api-reference/webhooks) by default, [polling](/api-reference/endpoints/generations/retrieve) optional.
* **Versioning:** the version is part of the URL (`/v1`). Backwards-incompatible changes ship under a new version.

## OpenAPI spec

The published OpenAPI 3.1 contract is served live by the API:

```
GET https://api.selektable.com/v1/openapi.json
```

The endpoint pages in this section are generated from that spec, so they always reflect the deployed version.

## Quickstart

1. Create an [API key](/api-reference/authentication) in the dashboard under **Account → API Keys**.
2. [Register a webhook endpoint](/api-reference/endpoints/webhook-endpoints/create) so you can receive results.
3. [Create a generation](/api-reference/endpoints/generations/create) with a customer photo and 1–3 products.
4. Verify the signature on incoming webhook events and use the `imageUrl` from the payload — or pick a smaller `imageVariants.{list,card,detail}` URL when you're embedding in emails, lists, or mobile.

## Requirements

* The public API requires an **active subscription**. Requests from organizations without one return `403 subscription_required`.
* Each API key is scoped to a single **store** within your organization; every generation it creates is attributed to that store.
* Keys are rate limited — see [Rate limits](/api-reference/rate-limits).

## Billing

Each completed generation consumes credits based on `imageSize`:

| Size           | Credits |
| -------------- | ------- |
| `1K` (default) | 1       |
| `2K`           | 2       |
| `4K`           | 3       |

Usage is metered against your subscription, the same as dashboard and Studio renders.