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
image-to-3d
Tidal Monitoring Cabin Environment Module$0.0269~46simport { 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',
settings: {
resolution: 1024,
textureSize: 2048,
remesh: true
},
inputs: {
image: 'https://assets.runware.ai/assets/inputs/5b472250-afda-43d5-be68-35ed6e3840a3.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",
"settings": {
"resolution": 1024,
"textureSize": 2048,
"remesh": True
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/5b472250-afda-43d5-be68-35ed6e3840a3.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": "45207280-bb45-45f9-b239-d2815554cb3c",
"model": "microsoft:trellis-2@4b",
"settings": {
"resolution": 1024,
"textureSize": 2048,
"remesh": true
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/5b472250-afda-43d5-be68-35ed6e3840a3.jpg"
}
}
]'runware run microsoft:trellis-2@4b \
settings.resolution=1024 \
settings.textureSize=2048 \
settings.remesh=true \
inputs.image=https://assets.runware.ai/assets/inputs/5b472250-afda-43d5-be68-35ed6e3840a3.jpg{
"taskType": "3dInference",
"taskUUID": "45207280-bb45-45f9-b239-d2815554cb3c",
"model": "microsoft:trellis-2@4b",
"settings": {
"resolution": 1024,
"textureSize": 2048,
"remesh": true
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/5b472250-afda-43d5-be68-35ed6e3840a3.jpg"
}
}Response
{
"taskType": "3dInference",
"taskUUID": "45207280-bb45-45f9-b239-d2815554cb3c",
"seed": 1415081447,
"cost": 0.0269,
"outputs": {
"files": [
{
"uuid": "216f663c-5e9e-4615-9b67-016f3d53257b",
"url": "https://im.runware.ai/image/os/a01d21/ws/5/ii/216f663c-5e9e-4615-9b67-016f3d53257b.glb"
}
]
}
}image-to-3d
Portable Farrier Hoof Stand Model$0.009~21simport { 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',
settings: {
resolution: 1024,
textureSize: 2048,
remesh: true
},
inputs: {
image: 'https://assets.runware.ai/assets/inputs/e35681d0-7043-4862-9eed-6698b538a1c1.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",
"settings": {
"resolution": 1024,
"textureSize": 2048,
"remesh": True
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/e35681d0-7043-4862-9eed-6698b538a1c1.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": "5613a9e3-0063-45f2-ae0a-858ba75bcfbb",
"model": "microsoft:trellis-2@4b",
"settings": {
"resolution": 1024,
"textureSize": 2048,
"remesh": true
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/e35681d0-7043-4862-9eed-6698b538a1c1.jpg"
}
}
]'runware run microsoft:trellis-2@4b \
settings.resolution=1024 \
settings.textureSize=2048 \
settings.remesh=true \
inputs.image=https://assets.runware.ai/assets/inputs/e35681d0-7043-4862-9eed-6698b538a1c1.jpg{
"taskType": "3dInference",
"taskUUID": "5613a9e3-0063-45f2-ae0a-858ba75bcfbb",
"model": "microsoft:trellis-2@4b",
"settings": {
"resolution": 1024,
"textureSize": 2048,
"remesh": true
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/e35681d0-7043-4862-9eed-6698b538a1c1.jpg"
}
}Response
{
"taskType": "3dInference",
"taskUUID": "5613a9e3-0063-45f2-ae0a-858ba75bcfbb",
"seed": 862915391,
"cost": 0.009,
"outputs": {
"files": [
{
"uuid": "4b231a5a-be00-4e3d-9a29-71c00acd579e",
"url": "https://im.runware.ai/image/os/a03d21/ws/5/ii/4b231a5a-be00-4e3d-9a29-71c00acd579e.glb"
}
]
}
}image-to-3d
Neon Laundromat Cutaway Set Module$0.0218~1m 19simport { 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',
settings: {
resolution: 1024,
textureSize: 2048,
remesh: true
},
inputs: {
image: 'https://assets.runware.ai/assets/inputs/c3ec2b8a-876e-43fd-a1bf-8d81bfa22c00.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",
"settings": {
"resolution": 1024,
"textureSize": 2048,
"remesh": True
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/c3ec2b8a-876e-43fd-a1bf-8d81bfa22c00.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": "d33c0123-ab89-4944-b8e4-206912b3ebdb",
"model": "microsoft:trellis-2@4b",
"settings": {
"resolution": 1024,
"textureSize": 2048,
"remesh": true
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/c3ec2b8a-876e-43fd-a1bf-8d81bfa22c00.jpg"
}
}
]'runware run microsoft:trellis-2@4b \
settings.resolution=1024 \
settings.textureSize=2048 \
settings.remesh=true \
inputs.image=https://assets.runware.ai/assets/inputs/c3ec2b8a-876e-43fd-a1bf-8d81bfa22c00.jpg{
"taskType": "3dInference",
"taskUUID": "d33c0123-ab89-4944-b8e4-206912b3ebdb",
"model": "microsoft:trellis-2@4b",
"settings": {
"resolution": 1024,
"textureSize": 2048,
"remesh": true
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/c3ec2b8a-876e-43fd-a1bf-8d81bfa22c00.jpg"
}
}Response
{
"taskType": "3dInference",
"taskUUID": "d33c0123-ab89-4944-b8e4-206912b3ebdb",
"seed": 124962657,
"cost": 0.0218,
"outputs": {
"files": [
{
"uuid": "2dbf311e-549a-42ba-81f1-1a9a1953c076",
"url": "https://im.runware.ai/image/os/a07dlim3/ws/5/ii/2dbf311e-549a-42ba-81f1-1a9a1953c076.glb"
}
]
}
}image-to-3d
Underground Safety Mole Character Model$0.0166~30simport { 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',
settings: {
resolution: 1024,
textureSize: 2048,
remesh: true
},
inputs: {
image: 'https://assets.runware.ai/assets/inputs/29d4381c-08b0-4359-851d-fd790502d615.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",
"settings": {
"resolution": 1024,
"textureSize": 2048,
"remesh": True
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/29d4381c-08b0-4359-851d-fd790502d615.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": "331e6717-e52d-4d5b-a2f3-e7706c692af2",
"model": "microsoft:trellis-2@4b",
"settings": {
"resolution": 1024,
"textureSize": 2048,
"remesh": true
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/29d4381c-08b0-4359-851d-fd790502d615.jpg"
}
}
]'runware run microsoft:trellis-2@4b \
settings.resolution=1024 \
settings.textureSize=2048 \
settings.remesh=true \
inputs.image=https://assets.runware.ai/assets/inputs/29d4381c-08b0-4359-851d-fd790502d615.jpg{
"taskType": "3dInference",
"taskUUID": "331e6717-e52d-4d5b-a2f3-e7706c692af2",
"model": "microsoft:trellis-2@4b",
"settings": {
"resolution": 1024,
"textureSize": 2048,
"remesh": true
},
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/29d4381c-08b0-4359-851d-fd790502d615.jpg"
}
}Response
{
"taskType": "3dInference",
"taskUUID": "331e6717-e52d-4d5b-a2f3-e7706c692af2",
"seed": 1772785070,
"cost": 0.0166,
"outputs": {
"files": [
{
"uuid": "c4f12b9a-0ef1-498d-8656-9a05e4fc772b",
"url": "https://im.runware.ai/image/os/a03d21/ws/5/ii/c4f12b9a-0ef1-498d-8656-9a05e4fc772b.glb"
}
]
}
}