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
| Name | Type | Details |
|---|---|---|
reference_imagesrequired | array of URLs | List of input images to generate 3D asset from Up to 10 files · Accepts image/* |
seed | number | Random seed for generation Default: |
texture_size | integer | GLB Extraction - Texture Size (only used if generate_model=True) Default: Min 512 · Max 2048 |
generate_color | boolean | Generate color video render Default: |
generate_model | boolean | Generate 3D model file (GLB) Default: |
generate_normal | boolean | Generate normal video render Default: |
mesh_simplify | number | GLB Extraction - Mesh Simplification (only used if generate_model=True) Default: Min 0.9 · Max 0.98 |
randomize_seed | boolean | Randomize seed Default: |
return_no_background | boolean | Return the preprocessed images without background Default: |
save_gaussian_ply | boolean | Save Gaussian point cloud as PLY file Default: |
slat_guidance_strength | number | Stage 2: Structured Latent Generation - Guidance Strength Default: Min 0 · Max 10 |
slat_sampling_steps | number | Stage 2: Structured Latent Generation - Sampling Steps Default: Min 1 · Max 50 |
sparse_structure_guidance_strength | number | Stage 1: Sparse Structure Generation - Guidance Strength Default: Min 0 · Max 10 |
sparse_structure_steps | number | Stage 1: Sparse Structure Generation - Sampling Steps Default: Min 1 · Max 50 |