---
title: "Preview Studio"
method: POST
path: "/api/estudio/preview"
tags: ["Estúdio Virtual"]
---

# Preview Studio

`POST /api/estudio/preview`

Configurator preview: one quick low-res Blender frame of `spec` with the
car-size box drawn in (or clean, `car_guide: none`), returned as JPEG. Synchronous
(a few seconds); 409 when a newer preview from the same user superseded this one,
503 without Blender.

## Headers

- `x-api-token` string, nullable

## Request body

- StudioPreviewIn
  - `spec` object, required
  - `profile_id` integer, nullable
  - `view` string, nullable — "preview" (overview), "camera" (the AI reference framing) or a view name
  - `car_category` string, nullable — the car size the frame is framed for (camera distance, room, platform); default berlina
  - `car_guide` string, nullable — "only" = the frame carries the car-size box (default); "none" = clean frame
  - `rigs` object, nullable — the builder's unsaved close-up cameras {view: {camera:[x,y,z], target:[x,y,z]}} for this preview only

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-23** `3405181d2cd1` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/multigest/apis/multigest-protected-api/changes/api/estudio/preview/post.md)

---

[API](https://skmtc.dev/multigest/apis/multigest-protected-api.md) · [All operations](https://skmtc.dev/multigest/apis/multigest-protected-api/llms.txt) · [OpenAPI document](https://skmtc.dev/multigest/apis/multigest-protected-api/revisions/447243444af4?raw)