Input

prompt

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.

image UrlUpload file

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.

model UrlUpload file

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.

resolution

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.

voxel Size Meters

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.

palette Size

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

symmetrical

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

hollow

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

name

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

params

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

Runs use your account credits. View this model’s prices100 credits = $1.00 USD · Charged for successful work.

Checking your session…

Output

A little curiosity. A new creation.

Give Voxel Generator an input and see what it can do. Your result will appear here.

Meet the model

Generate voxel assets for games

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.

What you can do

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

From experiment to application

Try a prompt in the playground, adjust the supported settings, then use the same model in your app. Your account balance works across the playground and API.

Connect an AI agent →

Creator

Sorceress

Make your first request

Use your Sorceress API key on your server. The playground uses your signed-in account; your application uses the same model with an API key.

cURL request

curl -X POST 'https://sorceress.games/api/v1/tools/voxel_generate' \
  -H 'Authorization: Bearer $SORCERESS_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{}'

Full endpoint reference →

Inputs & settings

promptstring

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

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

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

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

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

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

symmetricalboolean

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

hollowboolean

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

namestring

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

paramsobject

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

Full input schema

Input schema

{
  "required": [],
  "properties": {
    "prompt": {
      "type": "string",
      "title": "prompt",
      "description": "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."
    },
    "imageUrl": {
      "type": "string",
      "title": "image Url",
      "description": "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.",
      "format": "uri"
    },
    "modelUrl": {
      "type": "string",
      "title": "model Url",
      "description": "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.",
      "format": "uri"
    },
    "resolution": {
      "type": "number",
      "title": "resolution",
      "description": "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."
    },
    "voxelSizeMeters": {
      "type": "number",
      "title": "voxel Size Meters",
      "description": "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."
    },
    "paletteSize": {
      "type": "number",
      "title": "palette Size",
      "description": "Maximum distinct colours (default 256). Lower values give a flatter, more stylised look."
    },
    "symmetrical": {
      "type": "boolean",
      "title": "symmetrical",
      "description": "Mirror the model across its X axis. Useful for characters and vehicles, where an asymmetric source mesh reads as a mistake."
    },
    "hollow": {
      "type": "boolean",
      "title": "hollow",
      "description": "Drop fully enclosed interior voxels. Smaller files; only do this if nothing will ever cut the model open."
    },
    "name": {
      "type": "string",
      "title": "name",
      "description": "Name for the model, used for the output filenames and the entry in the Voxel Studio gallery."
    },
    "params": {
      "type": "object",
      "title": "params",
      "description": "Options passed through to the mesh model (see model_generate). Rarely needed — most of what they tune is quantized away."
    }
  }
}

Results, saved runs & billing

Media requests return a job ID. Poll GET /api/v1/jobs/:id until it succeeds or fails; keep the same ID while it is processing. Long chat requests can also return a saved job to poll. Completed outputs are stored in your account, and successful work is billed using your model's current rates.

A multi-step workflow may include separately billed successful actions. If a connection drops, check your saved run before submitting it again.

Know the cost

Pricing that makes sense

Dollar values are the USD equivalent of your Sorceress credits.

100 credits = $1.001 credit = $0.01 USD

Sorceress credits

Priced by usage

Mesh model cost + $0.05 (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.

1 credit = $0.01 · Successful work is billed on completion.

Review the supported inputs for duration, quantity and other usage-based charges before submitting. Read the billing guide →

Voxel Generator API