API docs / 3D models

trellis API

A powerful 3D asset generation model

Model id
firtoz/trellis
Provider
firtoz
Output
3D
Price
From 14 credits per run, the same as on voor.ai. Options such as length or resolution can change it.

Request

POST https://voor.ai/v1/generations with "model": "firtoz/trellis". Poll GET /v1/tasks/{id} or receive the signed webhook. See the overview for keys, idempotency, webhooks and errors.

curl https://voor.ai/v1/generations \
  -H "Authorization: Bearer $VOOR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "firtoz/trellis",
  "input": {
    "reference_images": [
      "https://example.com/input.png"
    ]
  },
  "callback_url": "https://example.com/webhooks/voor"
}'

# Then poll the task (or wait for the webhook):
curl https://voor.ai/v1/tasks/TASK_ID \
  -H "Authorization: Bearer $VOOR_API_KEY"

Input parameters

NameTypeDetails
reference_imagesrequiredarray of URLs

List of input images to generate 3D asset from

Up to 10 files · Accepts image/*

seednumber

Random seed for generation

Default: 0

texture_sizeinteger

GLB Extraction - Texture Size (only used if generate_model=True)

Default: 1024

Min 512 · Max 2048

generate_colorboolean

Generate color video render

Default: true

generate_modelboolean

Generate 3D model file (GLB)

Default: true

generate_normalboolean

Generate normal video render

Default: false

mesh_simplifynumber

GLB Extraction - Mesh Simplification (only used if generate_model=True)

Default: 0.95

Min 0.9 · Max 0.98

randomize_seedboolean

Randomize seed

Default: true

return_no_backgroundboolean

Return the preprocessed images without background

Default: false

save_gaussian_plyboolean

Save Gaussian point cloud as PLY file

Default: false

slat_guidance_strengthnumber

Stage 2: Structured Latent Generation - Guidance Strength

Default: 3

Min 0 · Max 10

slat_sampling_stepsnumber

Stage 2: Structured Latent Generation - Sampling Steps

Default: 12

Min 1 · Max 50

sparse_structure_guidance_strengthnumber

Stage 1: Sparse Structure Generation - Guidance Strength

Default: 7.5

Min 0 · Max 10

sparse_structure_stepsnumber

Stage 1: Sparse Structure Generation - Sampling Steps

Default: 12

Min 1 · Max 50