# v4.6 render engine

> Our newest engine, and the default in Studio. Engine id v4.6-ultra, $0.2475 a render.

Source: https://developers.mnml.ai/docs/models/v4-6-ultra

- **Render:** $0.2475 (per image)
- **Edit:** $0.099 (per edit)
- **References:** Up to 15 (Images per render)
- **Account:** Any account (Free and topped-up)

> [!TIP]
> The default engine: a render that names no `engine` runs on v4.6, as Studio does.

## Render with it

Name it in `engine`, by id (`"v4.6-ultra"`) or by name (`"v4.6"`), on [POST /v2/renders](https://developers.mnml.ai/docs/renders). The call answers `202` with a job; poll [GET /v2/jobs/{id}](https://developers.mnml.ai/docs/jobs) for the image.

**curl**

```bash
curl -X POST https://api.mnml.ai/v2/renders \
  -H "Authorization: Bearer $MNML_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "engine": "v4.6-ultra",
    "mode": "exterior",
    "image": "https://example.com/massing.png",
    "prompt": "Timber facade, late afternoon, olive trees"
  }'
```

**TypeScript**

```ts
const res = await fetch("https://api.mnml.ai/v2/renders", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.MNML_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "engine": "v4.6-ultra",
    "mode": "exterior",
    "image": "https://example.com/massing.png",
    "prompt": "Timber facade, late afternoon, olive trees"
  }),
});

const data = await res.json();
```

**Python**

```python
import os, requests

res = requests.post(
    "https://api.mnml.ai/v2/renders",
    headers={"Authorization": f"Bearer {os.environ['MNML_API_KEY']}"},
    json={
      "engine": "v4.6-ultra",
      "mode": "exterior",
      "image": "https://example.com/massing.png",
      "prompt": "Timber facade, late afternoon, olive trees"
    },
)

data = res.json()
```

## What it takes

| Feature | v4.6 |
| --- | --- |
| Render from a prompt alone (`mode: "text-to-render"`) | Yes |
| Reference images on a render | Up to 15 |
| Edits of the whole image | Run on this engine |
| Edits of an area (`region` or `mask`) | Run on this engine |
| Reference images on an edit | Yes |
| Studio’s `settings` | Yes, by mode: see below |

`mode` is one of `exterior`, `interior`, `masterplan`, `landscape`, `plan` or `product`, or `text-to-render` to render from the prompt alone.

## Price

| Call | Price |
| --- | --- |
| A render (`POST /v2/renders`) | $0.2475 |
| An edit (`POST /v2/edits`) | $0.099 |

`count` makes variations of one brief: each is its own job and its own charge. A job that fails, or that you cancel before it delivers, is refunded.

| Top-up | Renders on v4.6 |
| --- | --- |
| $10 | 40 renders |
| $25 | 101 renders |
| $50 | 202 renders |
| $100 | 404 renders |

## Settings by mode

Send `settings` as name → value, the same controls Studio shows for this engine and mode. Leave a setting out for Studio’s default. An unknown setting or value is refused before anything is charged; one that does not apply to your other choices comes back in `notes`.

> [!TIP]
> With `renderStyle: "raw"` and a prompt, the prompt is sent as written: the settings marked “not with RAW” are then left out and listed in `notes`.

**Mode: Exterior**

With `mode: "exterior"`, send for example `"settings": { "renderStyle": "cgi_render" }`.

- `renderStyle` (Render style): `auto`, `cgi_render`, `archviz`, `freehand_sketch`, `watercolor`, `illustration`, `diagram`, `cad`, `raw`.
- `camera` (Camera): `auto`, `eye_level`, `elevation`, `low`, `elevated`, `aerial`, `top_down`, `close_up`. Applies when `renderStyle` is not `cad` or `diagram`. Not with RAW style.
- `cameraDirection` (Direction): `front`, `corner_right`, `right`, `back_corner_right`, `back`, `back_corner_left`, `left`, `corner_left`. Applies when `camera` is set and not `auto` or `top_down` and `renderStyle` is not `cad` or `diagram`. Not with RAW style.
- `timeOfDay` (Time of day): `auto`, `golden_hour`, `blue_hour`, `night`. Applies when `renderStyle` is not `cad` or `diagram`. Not with RAW style.
- `weather` (Weather): `auto`, `clear`, `overcast`, `hazy`, `rain`, `fog`, `snow`. Applies when `renderStyle` is not `cad` or `diagram`. Not with RAW style.
- `people` (People): `auto`, `none`, `few`, `many`. Applies when `renderStyle` is not `cad` or `diagram`. Not with RAW style.
- `annotations` (Annotations): `off`, `remove`. Not with RAW style.
- `siteContext` (Site context): `auto`, `urban`, `suburban`, `nature`. Applies when `renderStyle` is not `cad`. Not with RAW style.
- `greenery` (Greenery): `auto`, `none`, `some`, `lush`. Applies when `renderStyle` is not `cad` or `diagram`. Not with RAW style.
- `vehicles` (Vehicles): `auto`, `none`, `few`, `many`. Applies when `renderStyle` is not `cad` or `diagram`. Not with RAW style.
- `groundWetness` (Ground wetness): `auto`, `dry`, `damp`, `wet`. Applies when `renderStyle` is not `cad`, `freehand_sketch`, `watercolor`, `illustration` or `diagram`. Not with RAW style.
- `motion` (Long exposure): `off`, `long_exposure`. Applies when `renderStyle` is not `cad`, `freehand_sketch`, `watercolor`, `illustration` or `diagram`. Not with RAW style.

**Mode: Interior**

With `mode: "interior"`, send for example `"settings": { "renderStyle": "cgi_render" }`.

- `renderStyle` (Render style): `auto`, `cgi_render`, `archviz`, `freehand_sketch`, `watercolor`, `illustration`, `diagram`, `cad`, `raw`.
- `roomType` (Room type): `auto`, `living room`, `bedroom`, `kitchen`, `bath room`, `office space`, `reception area`, `restaurant`, `dining room`, `hotel lobby`, `toilet`, `dressing room`, `loft`, `home office space`, `meeting room`, `coworking space`, `workshop`, `study room`, `gaming room`, `coffee shop`, `hotel room`, `hotel bathroom`, `auditorium`, `classroom`, `lecture hall`, `fitness gym`, `clothing store`. Applies when `renderStyle` is not `cad`. Not with RAW style.
- `roomStyle` (Room style): `auto`, `Modern interior`, `Minimalism, minimal interior`, `Neoclassical interior, symmetrical proportions, fluted columns and pilasters, ornate cornices and ceiling mouldings, carved wainscot panelling, marble floors, muted stone and cream palette with gilded accents, crystal chandelier, silk upholstery`, `Japandi, Minimalism, Natural materials, Neutral color palette, beige, Clean lines, Zen`, `Scandinavian interior`, `Industrial, leather furniture`, `Art Deco interior, 1920s glamour, bold symmetrical geometric patterns, sunburst and chevron motifs, polished brass and chrome trim, lacquered ebony and burl walnut, marble and onyx surfaces, velvet upholstery in emerald and navy, fluted glass, statement geometric lighting`, `Biophilic, biophilia, indoor plants`, `Luxurious, luxury interior`, `Boho Decor, bohemian, boho-chic style`, `wabi-sabi, Simplicity, Natural materials, Minimalism, Organic textures, Tranquility, Earthy tones, Serenity, Uncluttered`, `Coastal interior, shades of white and blue`, `Mediterranean, shades of white and blue, santorini`, `contemporary`, `Tropical`, `Rustic`, `Midcentury modern`, `Vintage`, `Futuristic interior style`, `Ikea interior style, Ikea furniture, colorful furniture, sleek design`, `warm and cozy`, `Eclectic`, `Zen Interior, Minimalism, Natural materials, Clean lines`, `Maximalist`, `Christmas`. Applies when `renderStyle` is not `cad`. Not with RAW style.
- `ambience` (Light): `auto`, `sun`, `golden_hour`, `blue_hour`, `night`. Applies when `renderStyle` is not `cad`. Not with RAW style.
- `lightingMode` (Lighting): `auto`, `natural`, `artificial`, `mixed`. Applies when `renderStyle` is not `cad` or `diagram` and `ambience` is not `night`. Not with RAW style.
- `people` (People): `auto`, `none`, `few`, `many`. Applies when `renderStyle` is not `cad` or `diagram`. Not with RAW style.
- `annotations` (Annotations): `off`, `remove`. Not with RAW style.
- `furnishingLevel` (Furnishing): `auto`, `empty`, `minimal`, `moderate`, `full`. Applies when `renderStyle` is not `cad`. Not with RAW style.
- `indoorPlants` (Indoor plants): `auto`, `none`, `some`, `lush`. Applies when `renderStyle` is not `cad`. Not with RAW style.
- `interiorAccessories` (Accessories): `auto`, `off`, `on`. Applies when `renderStyle` is not `cad`. Not with RAW style.
- `floorFinish` (Floor): `auto`, `reflective`. Applies when `renderStyle` is not `cad`, `freehand_sketch`, `watercolor`, `illustration` or `diagram`. Not with RAW style.
- `camera` (Camera): `auto`, `eye_level`, `wide_angle`, `close_up`, `low`, `elevated`, `top_down`, `elevation`. Applies when `renderStyle` is not `cad` or `diagram`. Not with RAW style.
- `cameraDirection` (Direction): `front`, `corner_right`, `right`, `back`, `left`, `corner_left`. Applies when `camera` is set and not `auto` or `top_down` and `renderStyle` is not `cad` or `diagram`. Not with RAW style.

**Mode: Masterplan**

With `mode: "masterplan"`, send for example `"settings": { "planMode": "3d" }`.

- `planMode` (Plan mode): `3d`, `2d`.
- `renderStyle` (Render style): `auto`, `cgi_render`, `archviz`, `raw`, `cad`, `freehand_sketch`, `diagram`, `clay_model`, `illustration`, `watercolor`.
- `camera` (Camera): `auto`, `top_down`, `high_aerial`, `low_aerial`, `oblique`. Applies when `planMode` is `3d` and `renderStyle` is not `cad` or `diagram`. Not with RAW style.
- `timeOfDay` (Time of day): `auto`, `day`, `golden_hour`, `dusk`, `night`. Not with RAW style.
- `weather` (Weather): `auto`, `clear`, `overcast`. Not with RAW style.
- `greenery` (Greenery): `auto`, `none`, `sparse`, `moderate`, `lush`. Not with RAW style.
- `vehicles` (Vehicles): `auto`, `none`, `few`, `moderate`, `busy`. Not with RAW style.
- `people` (People): `auto`, `none`, `few`, `moderate`, `crowded`. Not with RAW style.
- `urbanDensity` (Urban density): `auto`, `low`, `medium`, `high`. Not with RAW style.
- `developmentType` (Development type): `auto`, `residential`, `commercial`, `mixed_use`, `industrial`, `institutional`, `recreational`. Not with RAW style.
- `waterFeatures` (Water features): `auto`, `none`, `river`, `lake`, `coastal`, `fountains`. Not with RAW style.
- `annotations` (Annotations): `off`, `remove`. Not with RAW style.

**Mode: Landscape**

With `mode: "landscape"`, send for example `"settings": { "renderStyle": "photoreal" }`.

- `renderStyle` (Render style): `auto`, `photoreal`, `cgi_render`, `raw`, `cad`, `freehand_sketch`, `clay_model`, `illustration`, `diagram`, `watercolor`.
- `geometry` (Geometry): `precise`, `creative`. Not with RAW style.
- `landscapeStyle` (Landscape style): `modern`, `tropical`, `mediterranean`, `japanese`, `contemporary`, `natural`, `minimalist`, `classical`, `english_garden`. Not with RAW style.
- `camera` (Camera): `auto`, `eye_level`, `low`, `elevated`, `aerial`, `top_down`, `close_up`, `wide_angle`. Not with RAW style.
- `cameraDirection` (Direction): `front`, `corner_right`, `right`, `back_corner_right`, `back`, `back_corner_left`, `left`, `corner_left`. Applies when `camera` is set and not `auto` or `top_down`. Not with RAW style.
- `vegetation` (Vegetation): `sparse`, `moderate`, `lush`, `dense`. Not with RAW style.
- `waterFeatures` (Water features): `none`, `pond`, `pool`, `fountain`, `stream`, `waterfall`. Not with RAW style.
- `hardscape` (Hardscape): `minimal`, `pathways`, `patio`, `deck`, `full`. Not with RAW style.
- `outdoorFurniture` (Outdoor furniture): `none`, `minimal`, `moderate`, `full`. Not with RAW style.
- `landscapeLighting` (Lighting): `none`, `subtle`, `accent`, `dramatic`. Not with RAW style.
- `people` (People): `none`, `few`, `many`. Not with RAW style.
- `timeOfDay` (Time of day): `auto`, `day`, `morning`, `golden_hour`, `sunset`, `dusk`, `blue_hour`, `night`. Not with RAW style.
- `weather` (Weather): `clear`, `overcast`, `cloudy`, `hazy`, `rain`, `fog`, `snow`. Not with RAW style.
- `groundWetness` (Ground wetness): `dry`, `damp`, `wet`. Not with RAW style.
- `annotations` (Annotations): `off`, `remove`. Not with RAW style.

**Mode: Floor plan**

With `mode: "plan"`, send for example `"settings": { "planViewMode": "2d" }`.

- `planViewMode` (Output): `2d`, `3d`.
- `geometry` (Geometry): `precise`, `creative`.
- `drawingStyle` (Drawing style): `auto`, `realistic`, `technical`, `architectural`, `sketch`, `diagram`. Applies when `planViewMode` is not `3d`.
- `colorMode` (Color mode): `monochrome`, `grayscale`, `colored`. Applies when `planViewMode` is not `3d`.
- `planFurniture` (Furniture): `none`, `outline`, `detailed`. Applies when `planViewMode` is not `3d`.
- `annotations` (Annotations): `off`, `remove`. Applies when `planViewMode` is not `3d`.
- `wallStyle` (Wall style): `outlined`, `filled`, `poche`. Applies when `planViewMode` is not `3d`.
- `plan3dViewType` (Camera): `top_down`, `bird_eye`, `isometric`, `section`. Applies when `planViewMode` is `3d`.
- `cameraDirection` (Direction): `corner_left`, `corner_right`, `back_corner_right`, `back_corner_left`. Applies when `planViewMode` is `3d` and `plan3dViewType` is `isometric` or `bird_eye`.
- `plan3dCeiling` (Ceiling): `show`, `hide`. Applies when `planViewMode` is `3d`.
- `plan3dRoomStyle` (Room style): `auto`, `modern`, `minimalist`, `scandinavian`, `industrial`, `luxurious`, `traditional`. Applies when `planViewMode` is `3d`.
- `plan3dFurnishing` (Furnishing): `empty`, `minimal`, `moderate`, `full`. Applies when `planViewMode` is `3d`.
- `plan3dLighting` (Lighting): `natural`, `artificial`, `mixed`. Applies when `planViewMode` is `3d`.
- `plan3dAmbience` (Ambience): `day`, `golden_hour`, `evening`, `night`. Applies when `planViewMode` is `3d`.

**Mode: Product**

With `mode: "product"`, send for example `"settings": { "renderStyle": "photoreal" }`.

- `renderStyle` (Render style): `auto`, `photoreal`, `cgi_render`, `raw`, `cad`, `freehand_sketch`, `clay_model`, `illustration`, `diagram`, `watercolor`.
- `geometry` (Geometry): `precise`, `creative`. Not with RAW style.
- `productCategory` (Category): `furniture`, `lighting`, `decor`, `kitchenware`, `electronics`, `fashion`, `jewelry`, `packaging`, `industrial`, `automotive`. Not with RAW style.
- `camera` (Camera): `auto`, `hero`, `eye_level`, `elevated`, `top`, `detail`. Not with RAW style.
- `cameraDirection` (Direction): `front`, `corner_right`, `right`, `back_corner_right`, `back`, `back_corner_left`, `left`, `corner_left`. Applies when `camera` is set and not `auto` or `top`. Not with RAW style.
- `productBackground` (Background): `white`, `gradient`, `studio`, `contextual`, `transparent`. Not with RAW style.
- `productLighting` (Lighting): `soft`, `dramatic`, `natural`, `rim`, `flat`. Not with RAW style.
- `materialFinish` (Material finish): `auto`, `matte`, `glossy`, `metallic`, `textured`. Not with RAW style.
- `shadowStyle` (Shadow): `none`, `contact`, `soft`, `dramatic`, `reflection`. Not with RAW style.
- `annotations` (Annotations): `off`, `remove`. Not with RAW style.

**Mode: Text only**

With `mode: "text-to-render"`, send for example `"settings": { "renderStyle": "photoreal" }`.

- `renderStyle` (Render style): `auto`, `photoreal`, `cgi_render`, `raw`, `cad`, `freehand_sketch`, `clay_model`, `illustration`, `diagram`, `watercolor`.
- `geometry` (Geometry): `precise`, `creative`. Not with RAW style.
- `siteContext` (Site context): `auto`, `urban`, `suburban`, `nature`. Not with RAW style.
- `greenery` (Greenery): `none`, `some`, `lush`. Not with RAW style.
- `vehicles` (Vehicles): `none`, `few`, `many`. Not with RAW style.
- `people` (People): `none`, `few`, `many`. Not with RAW style.
- `streetProps` (Street props): `off`, `on`. Not with RAW style.
- `motion` (Motion): `off`, `subtle`, `long_exposure`. Not with RAW style.
- `timeOfDay` (Time of day): `auto`, `day`, `morning`, `golden_hour`, `sunset`, `dusk`, `blue_hour`, `night`. Not with RAW style.
- `weather` (Weather): `clear`, `overcast`, `cloudy`, `hazy`, `rain`, `fog`, `snow`. Not with RAW style.
- `groundWetness` (Ground wetness): `dry`, `damp`, `wet`. Not with RAW style.

## Related

- [Create a render](https://developers.mnml.ai/docs/renders): every field of the call.
- [Edit an image](https://developers.mnml.ai/docs/edits): change one thing and keep the rest.
- [List engines](https://developers.mnml.ai/docs/engines): these facts, live, for your account.
- [Pricing](https://developers.mnml.ai/docs/pricing): the wallet and every price.