Preview · API v2 is in development

The AI render API for architecture.

Turn sketches, 3D views and photos into photoreal renders from your own product. One REST API, the 8 engines behind mnml, and a fixed dollar price for every call.

$5 free on your first top-up · Prepaid, no subscription · REST from any language
$0.2475 per image
curl https://api.mnml.ai/v2/renders \  -H "Authorization: Bearer $MNML_API_KEY" \  -H "Content-Type: application/json" \  -H "Idempotency-Key: facade-042" \  -d '{    "engine": "v4.6-ultra",    "mode": "exterior",    "image": "https://example.com/massing.png",    "prompt": "Timber facade, late afternoon, olive trees"  }' # 202 → {"success":true,"data":{"id":"10482","status":"queued","charged_usd":0.2475,"credits_charged":25,"replayed":false,"notes":[],"ids":["10482"]}}curl https://api.mnml.ai/v2/jobs/10482 \  -H "Authorization: Bearer $MNML_API_KEY"
Example response

Press Run example to see the job a render returns.

Output
A rendered two-storey house with a timber porch and a glazed gable
render engines
8
the cheapest call
$0.0198
the smallest top-up
$10
free on your first top-up
$5
One API

Every stage of design, one consistent API

Renders, edits, enhancements and video share one key, one job shape and one set of error codes. Learn it once.

POST /v2/renders
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",    "aspect_ratio": "16:9"  }'
from $0.099Reference →
Engines

Built for architecture, not general images

The same engines that power mnml Studio. They keep your geometry and add materials, light and context.

v4.6$0.2475

Our newest engine, and the default in Studio.

engine: "v4.6-ultra"
v4.5 Ultra$0.297

Full-quality renders from sketches, models and photos.

engine: "v4.5-ultra"
v4.5 Fast$0.099

Quick drafts and options at a third of the Ultra price.

engine: "v4.5-fast"
A rendered residential street at dusk
Exteriorsmode: "exterior"
A rendered sunlit interior
Interiorsmode: "interior"
A rendered aerial masterplan at dusk
Masterplansmode: "masterplan"
A rendered landscape scheme
Landscapesmode: "landscape"
A rendered apartment floor plan
Floor plansmode: "plan"
A rendered commercial building at dusk
Commercialmode: "exterior"
Developer experience

Everything you need to ship

REST and OpenAPI

Available

JSON over HTTPS with one Bearer key. The OpenAPI 3.1 spec is generated from the same schemas the server validates with.

/v2/openapi.jsonBearer mk_live_…X-Request-Id

Typed SDKs

Available

TypeScript, Python, PHP, Go and .NET clients for every v2 call, typed against the spec, with createAndWait() for the poll loop, downloads, retries and webhook verification.

TypeScriptPythonPHPGo.NET
See the SDKs →

Console

Available

Keys, usage, a request log you can search by request id, billing and a playground, on your mnml.ai account.

KeysUsageRequest log

Signed webhooks

Available

A POST when a job finishes, signed with the Standard Webhooks scheme and retried for about a day.

webhook-signatureHMAC-SHA256
Use cases

What you can build with it

A rendered commercial building at dusk

Design and 3D tools

Add a Render button to a modelling app or plugin and turn the viewport into a client-ready image.

mode: "exterior"
A rendered sunlit interior

Property platforms

Show buyers a furnished, lit interior from an empty-room photo or a floor plan.

mode: "interior" · "plan"
A rendered aerial masterplan at dusk

Planning and urban tools

Turn site massing into aerial context views for consultations and competition boards.

mode: "masterplan"
APIs

A page for each job

Pricing

Pay as you go. No subscription.

Top up your API wallet with any amount from $10 to $5,000, and each call draws its listed price from your balance. Your first top-up adds $5 free, and failed jobs are refunded.

Engine or operationPrice
v4.6v4.6-ultra$0.2475per image
v4.5 Ultrav4.5-ultra$0.297per image
v4.5 Fastv4.5-fast$0.099per image
Editedit$0.099per edit
Upscaleupscale$0.0198per image
v2.0 · Flashv2.0-flash$0.99per 10s clip

Estimate your monthly cost

2,700 images
Estimated monthly cost$668.25Top-ups1 × $1,000

$0.2475 per image. Your balance never expires, and your first top-up adds $5 free.

Quickstart

Your first render in three steps

  1. Create an account and top up

    Sign up, or sign in with your mnml.ai account. Top up any amount from $10 to $5,000; your first top-up adds $5 free.

    https://developers.mnml.ai/signup
  2. Create an API key

    Make a key in the console and keep it on your server. It is shown once.

    export MNML_API_KEY=mk_live_…
  3. Send your first render

    POST an image and a prompt. With ?wait=90 the answer holds the finished render.

    curl "https://api.mnml.ai/v2/renders?wait=90" \
      -H "Authorization: Bearer $MNML_API_KEY" \
      -F [email protected] \
      -F engine=v4.6-ultra \
      -F prompt="Timber facade, dusk"

Questions

Is the API live?

Yes. API v2 is live for every mnml.ai account: sign in, top up your API wallet, create a key in the console and send your first render. The engines and price list are the ones mnml Studio uses.

Do I need a separate account or balance?

Same account, separate wallet. You sign in with your mnml.ai account, and the API spends from its own prepaid wallet. Your Studio plan and balance do not pay for API calls, and API top-ups do not pay for Studio.

How is it priced?

Prepaid, pay as you go. Top up any amount from $10 to $5,000, and each call draws its listed price from your balance: a v4.6 render is $0.2475. Your first top-up adds $5 free. There is no API subscription.

Can I render from an AI assistant today?

Yes. The mnml MCP server connects Claude and other assistants to your mnml account.

Start rendering from your own product.

Top up from $10, and your first top-up adds $5 free. The same account signs you in to Studio and the API.