Skip to main content
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).
  • Delivery: asynchronous — webhooks by default, polling 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 in the dashboard under Account → API Keys.
  2. Register a webhook endpoint so you can receive results.
  3. Create a generation 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.

​
Billing

Each completed generation consumes credits based on imageSize:
SizeCredits
1K (default)1
2K2
4K3
Usage is metered against your subscription, the same as dashboard and Studio renders.