3D generation, as an API call.
Everything you can do in the Dimensa studio, you can do from code. Build asset pipelines, user generated content features and on demand product models with a few lines.
import Dimensa from '@dimensa/sdk'; const dimensa = new Dimensa({ apiKey: process.env.DIMENSA_KEY }); // 1. generate four candidates from a prompt const job = await dimensa.models.generate({ prompt: 'mossy stone well, stylized, game ready', style: 'stylized-pbr', polyBudget: 8000, }); // 2. wait for it, then export the best one const [best] = await job.wait(); const url = await best.export({ format: 'glb', lods: 3 });
from dimensa import Dimensa client = Dimensa() # reads DIMENSA_KEY # 1. generate four candidates from a prompt job = client.models.generate( prompt="mossy stone well, stylized, game ready", style="stylized-pbr", poly_budget=8000, ) # 2. wait for it, then export the best one best = job.wait()[0] url = best.export(format="glb", lods=3)
curl https://api.dimensa.ai/v1/models \ -H "Authorization: Bearer $DIMENSA_KEY" \ -H "Content-Type: application/json" \ -d '{ "prompt": "mossy stone well, stylized, game ready", "style": "stylized-pbr", "poly_budget": 8000, "webhook_url": "https://example.com/hooks/dimensa" }' # => { "id": "job_8Hq2...", "status": "queued", "eta_seconds": 38 }
Live in five minutes.
Get a key
Create an API key in your Studio workspace settings. Keys are scoped per project and can be rotated at any time.
Install the SDK
npm i @dimensa/sdk or pip install dimensa. Both are typed and fully async.
Generate
Call models.generate, then poll, await or receive a webhook when your assets are ready.
Know the moment it's ready.
Every job emits signed events. Verify the Dimensa-Signature header with your webhook secret, then pull the files you need from short lived URLs.
- HMAC SHA-256 signatures with timestamp replay protection
- Retries with exponential backoff for up to 24 hours
- Event log and one click replays in the dashboard
{
"type": "model.completed",
"created": 1791500400,
"data": {
"id": "job_8Hq2kVd",
"prompt": "mossy stone well, stylized",
"candidates": [{
"id": "mdl_3fJx91",
"triangles": 7984,
"textures": "4k-pbr",
"files": { "glb": "https://cdn.dimensa.ai/…" }
}]
}
}
A small, predictable surface
Resource oriented REST over HTTPS with JSON bodies, idempotency keys and cursor pagination.
| Endpoint | What it does | Credits |
|---|---|---|
| POST /v1/models | Generate from a text prompt, images or a sketch | 20 |
| GET /v1/models/:id | Fetch a job, its status and candidates | 0 |
| POST /v1/models/:id/texture | Retexture with a new PBR material set | 10 |
| POST /v1/models/:id/rig | Auto rig and attach motions from the library | 5 |
| POST /v1/models/:id/remesh | Retopologize to a budget and build LODs | 5 |
| POST /v1/models/:id/export | Export to any of the 12 supported formats | 0 |
| DELETE /v1/models/:id | Permanently delete a model and its files | 0 |
Webhooks
Signed model.completed, model.failed and export.ready events with automatic retries.
Rate limits
60 requests per minute and 10 concurrent jobs on Studio. Enterprise limits are tuned to your volume.
Security
Scoped keys, TLS 1.3, encrypted storage and signed download URLs that expire after 24 hours.
Meet your tools where they live.
Blender add-on Beta
Generate, retexture and import from the N panel. Supports Blender 3.6 LTS and 4.x.
Unity package Beta
An editor window that drops prefabs with materials and LOD groups into your project.
Unreal plugin Q4
Nanite ready meshes and Material Instances generated straight into the content browser.
Godot addon Q4
Open source GDScript addon for Godot 4 with scene import and material mapping.
JavaScript SDK Beta
Typed client for Node, Deno, Bun and the browser, plus a drop in Three.js loader.
Python SDK Beta
Sync and async clients for pipelines, notebooks and DCC scripting environments.