Palatial API

Use the Palatial API to create SimReady 3D assets from images, text, or CAD files, track generation progress, and download results programmatically.

All routes below use your API key and live under:

<https://dashboard.palatial.cloud/api/v1/external/>

Contact Palatial if you need a sandbox or staging environment for integration testing.

Getting started

Create an API key in the Palatial dashboard (workspace settings). Keys are scoped to your workspace.
Send the key on every request using one of:
- Header: x-api-key: YOUR_API_KEY
- Header: Authorization: Bearer YOUR_API_KEY
- Query: ?api_key=YOUR_API_KEY
Create an asset with one of the generation endpoints (Image → Sim, Text → Sim, or CAD → Sim).
Poll status until the asset is READY (or handle PROCESSING_FAILED).
Download the SimReady export ZIP or individual outputs (mesh, texture, collisions, etc.).

Feature highlights

Generated texture size: use texture_size=2048, 4096, or 8192 for 2K, 4K, or 8K provider-generated textures. The default is 4096 (4K).
Texture delivery optimization: optimize_textures=true downsizes maps above texture_max_resolution. For Meshy outputs, eligible opaque base-color maps may be delivered as high-quality JPEG sidecars while technical maps remain lossless. It never upscales smaller maps.
Image-generated decimation compatibility: omitting decimation controls preserves the legacy adaptive reduction path. Pass decimation=false to explicitly disable it. New integrations may use decimation_mode=auto, or decimation_mode=strict with exactly one of decimation_target_faces or decimation_target_ratio. CAD omission remains disabled.

Authentication & access

Key type	What you can access
Workspace API key (recommended)	Assets and workspaces tied to that workspace
User-scoped key	Assets you own in your workspaces
Master key (enterprise)	Broader access; some calls require an explicit `owner` field

If you receive 403 Forbidden, check that the asset belongs to the workspace attached to your API key and that your workspace has sufficient export credits.