API docs / 3D models

trellis2 API

TRELLIS.2: Native and Compact Structured Latents for 3D Generation

Model id
fishwowater/trellis2
Provider
fishwowater
Output
3D
Price
Depends on the options; the same as on voor.ai.

Request

POST https://voor.ai/v1/generations with "model": "fishwowater/trellis2". 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": "fishwowater/trellis2",
  "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

Input image to generate 3D asset from

Up to 1 files · Accepts image/*

seednumber

Random seed for generation

Default: 42

texture_sizeinteger

Texture size for GLB export (only used if generate_model=True)

Default: 4096

Min 1024 · Max 8192

decimation_targetnumber

Target number of faces for decimation (only used if generate_model=True)

Default: 1000000

Min 100000 · Max 2000000

generate_modelboolean

Generate 3D model file (GLB)

Default: true

generate_videoboolean

Generate rendered video preview

Default: true

pipeline_typestring

Default: 1024_cascade

One of: 512, 1024, 1024_cascade, 1536_cascade

preprocess_imageboolean

Preprocess image (remove background and crop)

Default: true

randomize_seedboolean

Randomize seed

Default: false

return_no_backgroundboolean

Return the preprocessed image without background

Default: false

shape_slat_guidance_rescalenumber

Shape SLat guidance rescale

Default: 0.5

Min 0 · Max 1

shape_slat_guidance_strengthnumber

Shape SLat guidance strength

Default: 7.5

Min 0 · Max 15

shape_slat_rescale_tnumber

Shape SLat rescale T

Default: 3

Min 1 · Max 6

shape_slat_stepsnumber

Shape SLat sampling steps

Default: 12

Min 1 · Max 50

sparse_structure_guidance_rescalenumber

Sparse structure guidance rescale

Default: 0.7

Min 0 · Max 1

sparse_structure_guidance_strengthnumber

Sparse structure guidance strength

Default: 7.5

Min 0 · Max 15

sparse_structure_rescale_tnumber

Sparse structure rescale T

Default: 5

Min 1 · Max 6

sparse_structure_stepsnumber

Sparse structure sampling steps (more steps = better quality, slower)

Default: 12

Min 1 · Max 50

tex_slat_guidance_rescalenumber

Texture SLat guidance rescale

Default: 0

Min 0 · Max 1

tex_slat_guidance_strengthnumber

Texture SLat guidance strength

Default: 1

Min 0 · Max 15

tex_slat_rescale_tnumber

Texture SLat rescale T

Default: 3

Min 1 · Max 6

tex_slat_stepsnumber

Texture SLat sampling steps

Default: 12

Min 1 · Max 50