TRELLIS.2

TRELLIS.2 is a 4-billion-parameter 3D generative model that transforms 2D images into fully textured 3D assets with complex topology, sharp features, and physically based rendering materials. It uses a novel field-free sparse voxel representation and scalable structured latent space to enable efficient, high-resolution 3D generation from single image input.

API Reference
INTEGRATE
Complete technical specification for integration
RequestResponse
Examples4
CODE
Ready-to-use code snippets for common workflows
Ornate Fantasy Helmet
import { createClient } from '@runware/sdk'
const client = await createClient({ apiKey: process.env.RUNWARE_API_KEY })
await client.connect()
const [result] = await client.run({
model: 'microsoft:trellis-2@4b',
seed: 424242,
settings: {
textureSize: 4096,
decimationTarget: 500000,
remesh: true,
resolution: 1536,
sparseStructure: {
guidanceStrength: 8,
guidanceRescale: 0.7,
steps: 30,
rescaleT: 3
},
shapeSlat: {
guidanceStrength: 7.5,
guidanceRescale: 0.7,
steps: 28,
rescaleT: 3
},
texSlat: {
guidanceStrength: 8.5,
guidanceRescale: 0.6,
steps: 32,
rescaleT: 3
}
},
inputs: {
image: 'https://assets.runware.ai/assets/inputs/84e77cec-bda0-4930-94f8-cacad245251d.jpg'
}
})import asyncio
import os
from runware import Runware
async def main():
async with Runware(api_key=os.environ["RUNWARE_API_KEY"]) as client:
results = await client.run({
"model": "microsoft:trellis-2@4b",
"seed": 424242,
"settings": {
"textureSize": 4096,
"decimationTarget": 500000,
"remesh": True,
"resolution": 1536,
"sparseStructure": {
"guidanceStrength": 8,
"guidanceRescale": 0.7,
"steps": 30,
"rescaleT": 3
},
"shapeSlat": {
"guidanceStrength": 7.5,
"guidanceRescale": 0.7,
"steps": 28,
"rescaleT": 3
},
"texSlat": {
"guidanceStrength": 8.5,
"guidanceRescale": 0.6,
"steps": 32,
"rescaleT": 3
}
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/84e77cec-bda0-4930-94f8-cacad245251d.jpg"
}
})
asyncio.run(main())curl https://api.runware.ai/v1 \
-H "Authorization: Bearer $RUNWARE_API_KEY" \
-H "Content-Type: application/json" \
-d '[
{
"taskType": "3dInference",
"taskUUID": "0ccf2b8e-db45-4439-bba8-6a1420848399",
"model": "microsoft:trellis-2@4b",
"seed": 424242,
"settings": {
"textureSize": 4096,
"decimationTarget": 500000,
"remesh": true,
"resolution": 1536,
"sparseStructure": {
"guidanceStrength": 8,
"guidanceRescale": 0.7,
"steps": 30,
"rescaleT": 3
},
"shapeSlat": {
"guidanceStrength": 7.5,
"guidanceRescale": 0.7,
"steps": 28,
"rescaleT": 3
},
"texSlat": {
"guidanceStrength": 8.5,
"guidanceRescale": 0.6,
"steps": 32,
"rescaleT": 3
}
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/84e77cec-bda0-4930-94f8-cacad245251d.jpg"
}
}
]'runware run microsoft:trellis-2@4b \
seed=424242 \
settings.textureSize=4096 \
settings.decimationTarget=500000 \
settings.remesh=true \
settings.resolution=1536 \
settings.sparseStructure.guidanceStrength=8 \
settings.sparseStructure.guidanceRescale=0.7 \
settings.sparseStructure.steps=30 \
settings.sparseStructure.rescaleT=3 \
settings.shapeSlat.guidanceStrength=7.5 \
settings.shapeSlat.guidanceRescale=0.7 \
settings.shapeSlat.steps=28 \
settings.shapeSlat.rescaleT=3 \
settings.texSlat.guidanceStrength=8.5 \
settings.texSlat.guidanceRescale=0.6 \
settings.texSlat.steps=32 \
settings.texSlat.rescaleT=3 \
inputs.image=https://assets.runware.ai/assets/inputs/84e77cec-bda0-4930-94f8-cacad245251d.jpg{
"taskType": "3dInference",
"taskUUID": "0ccf2b8e-db45-4439-bba8-6a1420848399",
"model": "microsoft:trellis-2@4b",
"seed": 424242,
"settings": {
"textureSize": 4096,
"decimationTarget": 500000,
"remesh": true,
"resolution": 1536,
"sparseStructure": {
"guidanceStrength": 8,
"guidanceRescale": 0.7,
"steps": 30,
"rescaleT": 3
},
"shapeSlat": {
"guidanceStrength": 7.5,
"guidanceRescale": 0.7,
"steps": 28,
"rescaleT": 3
},
"texSlat": {
"guidanceStrength": 8.5,
"guidanceRescale": 0.6,
"steps": 32,
"rescaleT": 3
}
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/84e77cec-bda0-4930-94f8-cacad245251d.jpg"
}
}{
"taskType": "3dInference",
"taskUUID": "0ccf2b8e-db45-4439-bba8-6a1420848399",
"seed": 424242,
"cost": 0.0454,
"outputs": {
"files": [
{
"uuid": "7e34d8eb-0823-4d73-bde7-8599a08bb505",
"url": "https://im.runware.ai/image/os/a05d22/ws/4/ii/7e34d8eb-0823-4d73-bde7-8599a08bb505.glb"
}
]
}
}Orc Character Bust
import { createClient } from '@runware/sdk'
const client = await createClient({ apiKey: process.env.RUNWARE_API_KEY })
await client.connect()
const [result] = await client.run({
model: 'microsoft:trellis-2@4b',
seed: 424242,
settings: {
textureSize: 2048,
decimationTarget: 500000,
remesh: true,
resolution: 1024,
sparseStructure: {
guidanceStrength: 8,
guidanceRescale: 0.7,
steps: 30,
rescaleT: 3
},
shapeSlat: {
guidanceStrength: 7.5,
guidanceRescale: 0.7,
steps: 28,
rescaleT: 3
},
texSlat: {
guidanceStrength: 8.5,
guidanceRescale: 0.6,
steps: 30,
rescaleT: 3
}
},
inputs: {
image: 'https://assets.runware.ai/assets/inputs/41d320a9-1ed2-4dd8-9727-d83297535d02.jpg'
}
})import asyncio
import os
from runware import Runware
async def main():
async with Runware(api_key=os.environ["RUNWARE_API_KEY"]) as client:
results = await client.run({
"model": "microsoft:trellis-2@4b",
"seed": 424242,
"settings": {
"textureSize": 2048,
"decimationTarget": 500000,
"remesh": True,
"resolution": 1024,
"sparseStructure": {
"guidanceStrength": 8,
"guidanceRescale": 0.7,
"steps": 30,
"rescaleT": 3
},
"shapeSlat": {
"guidanceStrength": 7.5,
"guidanceRescale": 0.7,
"steps": 28,
"rescaleT": 3
},
"texSlat": {
"guidanceStrength": 8.5,
"guidanceRescale": 0.6,
"steps": 30,
"rescaleT": 3
}
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/41d320a9-1ed2-4dd8-9727-d83297535d02.jpg"
}
})
asyncio.run(main())curl https://api.runware.ai/v1 \
-H "Authorization: Bearer $RUNWARE_API_KEY" \
-H "Content-Type: application/json" \
-d '[
{
"taskType": "3dInference",
"taskUUID": "bd373968-8512-4315-a95f-95a4401fea3e",
"model": "microsoft:trellis-2@4b",
"seed": 424242,
"settings": {
"textureSize": 2048,
"decimationTarget": 500000,
"remesh": true,
"resolution": 1024,
"sparseStructure": {
"guidanceStrength": 8,
"guidanceRescale": 0.7,
"steps": 30,
"rescaleT": 3
},
"shapeSlat": {
"guidanceStrength": 7.5,
"guidanceRescale": 0.7,
"steps": 28,
"rescaleT": 3
},
"texSlat": {
"guidanceStrength": 8.5,
"guidanceRescale": 0.6,
"steps": 30,
"rescaleT": 3
}
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/41d320a9-1ed2-4dd8-9727-d83297535d02.jpg"
}
}
]'runware run microsoft:trellis-2@4b \
seed=424242 \
settings.textureSize=2048 \
settings.decimationTarget=500000 \
settings.remesh=true \
settings.resolution=1024 \
settings.sparseStructure.guidanceStrength=8 \
settings.sparseStructure.guidanceRescale=0.7 \
settings.sparseStructure.steps=30 \
settings.sparseStructure.rescaleT=3 \
settings.shapeSlat.guidanceStrength=7.5 \
settings.shapeSlat.guidanceRescale=0.7 \
settings.shapeSlat.steps=28 \
settings.shapeSlat.rescaleT=3 \
settings.texSlat.guidanceStrength=8.5 \
settings.texSlat.guidanceRescale=0.6 \
settings.texSlat.steps=30 \
settings.texSlat.rescaleT=3 \
inputs.image=https://assets.runware.ai/assets/inputs/41d320a9-1ed2-4dd8-9727-d83297535d02.jpg{
"taskType": "3dInference",
"taskUUID": "bd373968-8512-4315-a95f-95a4401fea3e",
"model": "microsoft:trellis-2@4b",
"seed": 424242,
"settings": {
"textureSize": 2048,
"decimationTarget": 500000,
"remesh": true,
"resolution": 1024,
"sparseStructure": {
"guidanceStrength": 8,
"guidanceRescale": 0.7,
"steps": 30,
"rescaleT": 3
},
"shapeSlat": {
"guidanceStrength": 7.5,
"guidanceRescale": 0.7,
"steps": 28,
"rescaleT": 3
},
"texSlat": {
"guidanceStrength": 8.5,
"guidanceRescale": 0.6,
"steps": 30,
"rescaleT": 3
}
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/41d320a9-1ed2-4dd8-9727-d83297535d02.jpg"
}
}{
"taskType": "3dInference",
"taskUUID": "bd373968-8512-4315-a95f-95a4401fea3e",
"seed": 424242,
"cost": 0.055,
"outputs": {
"files": [
{
"uuid": "112a24e5-7976-46b3-a22c-e658daaffdfe",
"url": "https://im.runware.ai/image/os/a01d21/ws/4/ii/112a24e5-7976-46b3-a22c-e658daaffdfe.glb"
}
]
}
}Hero Product Figurine
import { createClient } from '@runware/sdk'
const client = await createClient({ apiKey: process.env.RUNWARE_API_KEY })
await client.connect()
const [result] = await client.run({
model: 'microsoft:trellis-2@4b',
seed: 424242,
settings: {
textureSize: 4096,
decimationTarget: 500000,
remesh: true,
resolution: 1536,
sparseStructure: {
guidanceStrength: 8,
guidanceRescale: 0.7,
steps: 28,
rescaleT: 3
},
shapeSlat: {
guidanceStrength: 7.5,
guidanceRescale: 0.7,
steps: 30,
rescaleT: 3
},
texSlat: {
guidanceStrength: 8.5,
guidanceRescale: 0.6,
steps: 32,
rescaleT: 3
}
},
inputs: {
image: 'https://assets.runware.ai/assets/inputs/223fe72c-93a2-4a97-9c2a-81183a365353.jpg'
}
})import asyncio
import os
from runware import Runware
async def main():
async with Runware(api_key=os.environ["RUNWARE_API_KEY"]) as client:
results = await client.run({
"model": "microsoft:trellis-2@4b",
"seed": 424242,
"settings": {
"textureSize": 4096,
"decimationTarget": 500000,
"remesh": True,
"resolution": 1536,
"sparseStructure": {
"guidanceStrength": 8,
"guidanceRescale": 0.7,
"steps": 28,
"rescaleT": 3
},
"shapeSlat": {
"guidanceStrength": 7.5,
"guidanceRescale": 0.7,
"steps": 30,
"rescaleT": 3
},
"texSlat": {
"guidanceStrength": 8.5,
"guidanceRescale": 0.6,
"steps": 32,
"rescaleT": 3
}
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/223fe72c-93a2-4a97-9c2a-81183a365353.jpg"
}
})
asyncio.run(main())curl https://api.runware.ai/v1 \
-H "Authorization: Bearer $RUNWARE_API_KEY" \
-H "Content-Type: application/json" \
-d '[
{
"taskType": "3dInference",
"taskUUID": "a8970b6f-a3d2-4fcd-abdb-6d44ac3477f0",
"model": "microsoft:trellis-2@4b",
"seed": 424242,
"settings": {
"textureSize": 4096,
"decimationTarget": 500000,
"remesh": true,
"resolution": 1536,
"sparseStructure": {
"guidanceStrength": 8,
"guidanceRescale": 0.7,
"steps": 28,
"rescaleT": 3
},
"shapeSlat": {
"guidanceStrength": 7.5,
"guidanceRescale": 0.7,
"steps": 30,
"rescaleT": 3
},
"texSlat": {
"guidanceStrength": 8.5,
"guidanceRescale": 0.6,
"steps": 32,
"rescaleT": 3
}
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/223fe72c-93a2-4a97-9c2a-81183a365353.jpg"
}
}
]'runware run microsoft:trellis-2@4b \
seed=424242 \
settings.textureSize=4096 \
settings.decimationTarget=500000 \
settings.remesh=true \
settings.resolution=1536 \
settings.sparseStructure.guidanceStrength=8 \
settings.sparseStructure.guidanceRescale=0.7 \
settings.sparseStructure.steps=28 \
settings.sparseStructure.rescaleT=3 \
settings.shapeSlat.guidanceStrength=7.5 \
settings.shapeSlat.guidanceRescale=0.7 \
settings.shapeSlat.steps=30 \
settings.shapeSlat.rescaleT=3 \
settings.texSlat.guidanceStrength=8.5 \
settings.texSlat.guidanceRescale=0.6 \
settings.texSlat.steps=32 \
settings.texSlat.rescaleT=3 \
inputs.image=https://assets.runware.ai/assets/inputs/223fe72c-93a2-4a97-9c2a-81183a365353.jpg{
"taskType": "3dInference",
"taskUUID": "a8970b6f-a3d2-4fcd-abdb-6d44ac3477f0",
"model": "microsoft:trellis-2@4b",
"seed": 424242,
"settings": {
"textureSize": 4096,
"decimationTarget": 500000,
"remesh": true,
"resolution": 1536,
"sparseStructure": {
"guidanceStrength": 8,
"guidanceRescale": 0.7,
"steps": 28,
"rescaleT": 3
},
"shapeSlat": {
"guidanceStrength": 7.5,
"guidanceRescale": 0.7,
"steps": 30,
"rescaleT": 3
},
"texSlat": {
"guidanceStrength": 8.5,
"guidanceRescale": 0.6,
"steps": 32,
"rescaleT": 3
}
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/223fe72c-93a2-4a97-9c2a-81183a365353.jpg"
}
}{
"taskType": "3dInference",
"taskUUID": "a8970b6f-a3d2-4fcd-abdb-6d44ac3477f0",
"seed": 424242,
"cost": 0.0314,
"outputs": {
"files": [
{
"uuid": "6568996e-9567-4a40-84b4-1cc6202fe043",
"url": "https://im.runware.ai/image/os/a03d21/ws/4/ii/6568996e-9567-4a40-84b4-1cc6202fe043.glb"
}
]
}
}Ornate Dragon Figurine
import { createClient } from '@runware/sdk'
const client = await createClient({ apiKey: process.env.RUNWARE_API_KEY })
await client.connect()
const [result] = await client.run({
model: 'microsoft:trellis-2@4b',
seed: 246813579,
settings: {
textureSize: 4096,
decimationTarget: 500000,
remesh: true,
resolution: 1536,
sparseStructure: {
guidanceStrength: 8,
guidanceRescale: 0.7,
steps: 30,
rescaleT: 3
},
shapeSlat: {
guidanceStrength: 7.5,
guidanceRescale: 0.7,
steps: 28,
rescaleT: 3
},
texSlat: {
guidanceStrength: 8.5,
guidanceRescale: 0.6,
steps: 32,
rescaleT: 3
}
},
inputs: {
image: 'https://assets.runware.ai/assets/inputs/59b5b9e2-7083-4adf-88be-2793dab06233.jpg'
}
})import asyncio
import os
from runware import Runware
async def main():
async with Runware(api_key=os.environ["RUNWARE_API_KEY"]) as client:
results = await client.run({
"model": "microsoft:trellis-2@4b",
"seed": 246813579,
"settings": {
"textureSize": 4096,
"decimationTarget": 500000,
"remesh": True,
"resolution": 1536,
"sparseStructure": {
"guidanceStrength": 8,
"guidanceRescale": 0.7,
"steps": 30,
"rescaleT": 3
},
"shapeSlat": {
"guidanceStrength": 7.5,
"guidanceRescale": 0.7,
"steps": 28,
"rescaleT": 3
},
"texSlat": {
"guidanceStrength": 8.5,
"guidanceRescale": 0.6,
"steps": 32,
"rescaleT": 3
}
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/59b5b9e2-7083-4adf-88be-2793dab06233.jpg"
}
})
asyncio.run(main())curl https://api.runware.ai/v1 \
-H "Authorization: Bearer $RUNWARE_API_KEY" \
-H "Content-Type: application/json" \
-d '[
{
"taskType": "3dInference",
"taskUUID": "5efab433-316e-4b0b-b8c4-6e0edbe3779c",
"model": "microsoft:trellis-2@4b",
"seed": 246813579,
"settings": {
"textureSize": 4096,
"decimationTarget": 500000,
"remesh": true,
"resolution": 1536,
"sparseStructure": {
"guidanceStrength": 8,
"guidanceRescale": 0.7,
"steps": 30,
"rescaleT": 3
},
"shapeSlat": {
"guidanceStrength": 7.5,
"guidanceRescale": 0.7,
"steps": 28,
"rescaleT": 3
},
"texSlat": {
"guidanceStrength": 8.5,
"guidanceRescale": 0.6,
"steps": 32,
"rescaleT": 3
}
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/59b5b9e2-7083-4adf-88be-2793dab06233.jpg"
}
}
]'runware run microsoft:trellis-2@4b \
seed=246813579 \
settings.textureSize=4096 \
settings.decimationTarget=500000 \
settings.remesh=true \
settings.resolution=1536 \
settings.sparseStructure.guidanceStrength=8 \
settings.sparseStructure.guidanceRescale=0.7 \
settings.sparseStructure.steps=30 \
settings.sparseStructure.rescaleT=3 \
settings.shapeSlat.guidanceStrength=7.5 \
settings.shapeSlat.guidanceRescale=0.7 \
settings.shapeSlat.steps=28 \
settings.shapeSlat.rescaleT=3 \
settings.texSlat.guidanceStrength=8.5 \
settings.texSlat.guidanceRescale=0.6 \
settings.texSlat.steps=32 \
settings.texSlat.rescaleT=3 \
inputs.image=https://assets.runware.ai/assets/inputs/59b5b9e2-7083-4adf-88be-2793dab06233.jpg{
"taskType": "3dInference",
"taskUUID": "5efab433-316e-4b0b-b8c4-6e0edbe3779c",
"model": "microsoft:trellis-2@4b",
"seed": 246813579,
"settings": {
"textureSize": 4096,
"decimationTarget": 500000,
"remesh": true,
"resolution": 1536,
"sparseStructure": {
"guidanceStrength": 8,
"guidanceRescale": 0.7,
"steps": 30,
"rescaleT": 3
},
"shapeSlat": {
"guidanceStrength": 7.5,
"guidanceRescale": 0.7,
"steps": 28,
"rescaleT": 3
},
"texSlat": {
"guidanceStrength": 8.5,
"guidanceRescale": 0.6,
"steps": 32,
"rescaleT": 3
}
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/59b5b9e2-7083-4adf-88be-2793dab06233.jpg"
}
}{
"taskType": "3dInference",
"taskUUID": "5efab433-316e-4b0b-b8c4-6e0edbe3779c",
"seed": 246813579,
"cost": 0.0198,
"outputs": {
"files": [
{
"uuid": "2dba7e00-adc6-410e-bcf9-7011266bf24f",
"url": "https://im.runware.ai/image/os/a24d12/ws/4/ii/2dba7e00-adc6-410e-bcf9-7011266bf24f.glb"
}
]
}
}