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
| Name | Type | Details |
|---|---|---|
reference_imagesrequired | array of URLs | Input image to generate 3D asset from Up to 1 files · Accepts image/* |
seed | number | Random seed for generation Default: |
texture_size | integer | Texture size for GLB export (only used if generate_model=True) Default: Min 1024 · Max 8192 |
decimation_target | number | Target number of faces for decimation (only used if generate_model=True) Default: Min 100000 · Max 2000000 |
generate_model | boolean | Generate 3D model file (GLB) Default: |
generate_video | boolean | Generate rendered video preview Default: |
pipeline_type | string | Default: One of: 512, 1024, 1024_cascade, 1536_cascade |
preprocess_image | boolean | Preprocess image (remove background and crop) Default: |
randomize_seed | boolean | Randomize seed Default: |
return_no_background | boolean | Return the preprocessed image without background Default: |
shape_slat_guidance_rescale | number | Shape SLat guidance rescale Default: Min 0 · Max 1 |
shape_slat_guidance_strength | number | Shape SLat guidance strength Default: Min 0 · Max 15 |
shape_slat_rescale_t | number | Shape SLat rescale T Default: Min 1 · Max 6 |
shape_slat_steps | number | Shape SLat sampling steps Default: Min 1 · Max 50 |
sparse_structure_guidance_rescale | number | Sparse structure guidance rescale Default: Min 0 · Max 1 |
sparse_structure_guidance_strength | number | Sparse structure guidance strength Default: Min 0 · Max 15 |
sparse_structure_rescale_t | number | Sparse structure rescale T Default: Min 1 · Max 6 |
sparse_structure_steps | number | Sparse structure sampling steps (more steps = better quality, slower) Default: Min 1 · Max 50 |
tex_slat_guidance_rescale | number | Texture SLat guidance rescale Default: Min 0 · Max 1 |
tex_slat_guidance_strength | number | Texture SLat guidance strength Default: Min 0 · Max 15 |
tex_slat_rescale_t | number | Texture SLat rescale T Default: Min 1 · Max 6 |
tex_slat_steps | number | Texture SLat sampling steps Default: Min 1 · Max 50 |