---
title: "Render Profile"
method: POST
path: "/api/estudio/profiles/{profile_id}/render"
tags: ["Estúdio Virtual"]
---

# Render Profile

`POST /api/estudio/profiles/{profile_id}/render`

Render the studio for one lens (a batch per phone camera + frame aspect) and one
car category (its guide frames). A batch that already has that category for the
current spec answers `{status: "ready"}` at once; a batch missing only the category
renders just its guide frames.

## Path parameters

- `profile_id` integer, required

## Query parameters

- `force` boolean — abandon a render that looks stuck and start again (or re-render an existing batch)

## Headers

- `x-api-token` string, nullable

## Request body

- RenderIn
  - `focal_mm` number, nullable — the phone's 35 mm-equivalent focal (default 26)
  - `aspect` number, nullable — the frame aspect w/h (default 3:2)
  - `car_category` string, nullable — the car category whose guide frames to render (default berlina)

## Response `202`

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/profiles/:profile_id/render/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)