Sorceress · 3D

Voxel Generator API

Generate a coloured voxel model from a text prompt, an image, or an existing GLB (pass modelUrl to voxelize a mesh you already have). Returns a game-ready GLB with per-voxel vertex colours standing on y=0, plus a .wgvox that opens in the Sorceress Voxel Studio, the raw voxel JSON and a preview PNG. Control the look with resolution (8-128 voxels along the longest axis) and the real-world size with voxelSizeMeters. Async: returns a jobId — poll GET /api/v1/jobs/:id until it succeeds, then read result.voxel.

Available through Sorceress API

Use with an AI agentManage API keys
Voxel Generator model artwork

Using Voxel Generator in your workflow

Sorceress brings this custom workflow into a shared API catalog. Select this model explicitly, check its supported inputs, and keep your API key on your server. Model capabilities differ; the schema and options on this page describe this entry rather than every model from the same brand.

  • Create voxel assets for game prototypes.
  • Use the documented export format to bring the result into your project.

Pricing and availability

Mesh model cost + 5 credits for voxelization (35 for a default image-to-voxel). Voxelizing your own mesh via modelUrl costs only 5. Charged in credits only on success.. Successful work is billed in Sorceress credits. Defaults and optional inputs can affect the total.

Inputs and supported options

promptstring · optional

Text description for text→voxel, e.g. "a wooden treasure chest with iron bands". Detail below roughly one voxel is lost, so describe bold shapes and colours rather than fine surface texture.

imageUrlstring · optional

https image URL for image→voxel — usually the better result. Generate a reference with image_generate first (a single object, plain background), then pass its URL here.

modelUrlstring · optional

https URL of an existing .glb to voxelize instead of generating a new mesh — e.g. the mesh from model_generate. Skips the model fee, so the call costs only 5 credits.

resolutionnumber · optional

Voxels along the model's longest axis, 8–128 (default 64). 16–32 reads as chunky retro blocks; 64 keeps recognisable detail; 128 is near-sculptural and much heavier.

voxelSizeMetersnumber · optional

Edge length of one voxel in the exported GLB (default 0.05). This sets the model's real-world size: resolution 64 at 0.05 gives a ~3.2 m object. Set it here rather than scaling the GLB after loading.

paletteSizenumber · optional

Maximum distinct colours (default 256). Lower values give a flatter, more stylised look.

symmetricalboolean · optional

Mirror the model across its X axis. Useful for characters and vehicles, where an asymmetric source mesh reads as a mistake.

hollowboolean · optional

Drop fully enclosed interior voxels. Smaller files; only do this if nothing will ever cut the model open.

namestring · optional

Name for the model, used for the output filenames and the entry in the Voxel Studio gallery.

modelstring · optional

Mesh model used before voxelization. One of: hunyuan3d-3.1, tripo-v3.1, meshy-6, meshy-7. Defaults to hunyuan3d-3.1 for images and meshy-6 for text. The grid discards fine geometry, so the default is usually the right spend.

paramsobject · optional

Options passed through to the mesh model (see model_generate). Rarely needed — most of what they tune is quantized away.

API request template

Replace placeholders and choose valid values from the input contract. 

POST /api/v1/tools/voxel_generate
Authorization: Bearer $SORCERESS_API_KEY
Content-Type: application/json

{}
Read the endpoint reference →

Completion, results and billing

Save the job identifier returned by asynchronous requests and poll the jobs endpoint until the job succeeds or fails. Do not resubmit a generation just because it is still processing. Chat returns a completed reply and usage details. A multi-step workflow can include separately billed successful steps even if a later step fails. Keep returned asset links with your project, and consult each action for its output format.

Coding agents can discover the current catalog and input requirements from the Sorceress agent instructions. Use a Sorceress key; provider credentials stay on the server.