A casino game thumbnail API for catalogues of any size
Register a game, generate a master image, export every lobby format — from your own back office. The Slot Preview AI REST API runs the same flow as the web constructor, at the same prices in tokens.
The flow in four calls
- Register the game, or find it in the catalogue. Free.
- Generate a master:
POST /v1/masters, two variants for 1 token. The call is asynchronous and answers202 Acceptedwith a job and a polling address. - Preview the caption: draw the title and the studio name on the master for free before you pay for anything else.
- Export: 2 tokens for the whole set of 13 files in 6 aspect ratios, plus a ZIP archive and a manifest.
Step-by-step requests with recorded responses are in the quickstart; every endpoint is in the API reference.
Built for production integrations
- Price before you pay. Estimate endpoints return the cost; send
max_tokensand a call that would cost more is refused before anything is charged. - Safe retries. An
Idempotency-Keyreturns the original job and charges nothing on a repeat. - Webhooks. Subscribe to
master.generation.completedinstead of polling. - Sandbox. A sandbox key returns fixtures, never calls the image model and charges nothing, so the integration you test is the one you ship.
- SDKs. TypeScript and PHP SDKs, a Postman collection and an OpenAPI document.
- Batch. A CSV in, a queue that survives a restart, one export set per game.
Keys, scopes and the sandbox are described in authentication and environments, every error code in errors and limits.
Or let an AI agent do it
The MCP server exposes the same flow to ChatGPT, Claude, Cursor or your own agent: it finds the game, prices each step, brings back both variants and exports the set, stopping at the daily token cap you set.
What one export returns
| Ratio | Files | Pixel sizes |
|---|---|---|
| 2:3 | Files:2 | Pixel sizes:512×768 · 1024×1536 (@2x) |
| 3:4 | Files:3 | Pixel sizes:768×1024 · 427×575 · 316×425 |
| 1:1 | Files:3 | Pixel sizes:1024×1024 · 380×380 · 190×190 |
| 9:16 | Files:1 | Pixel sizes:864×1536 |
| 16:9 | Files:2 | Pixel sizes:1536×864 · 337×181 |
| 21:9 | Files:2 | Pixel sizes:1540×660 · 236×110 |
Questions operators ask
Is there a free way to test the API?
Yes. A sandbox key is free, never calls the image model and returns built-in fixtures, while polling, webhooks, idempotency and price limits behave as in production.
Which calls cost tokens?
Only two: generating a master (1 token for two variants) and exporting the format set (2 tokens). The catalogue, previews, polling and downloads are free.
Can I generate thumbnails for my whole catalogue?
Yes. Use the batch runner with a CSV of games, or loop over the API. Each game gets its own export set.
