MODEL IDmicrosoft:trellis-2@4b
live

TRELLIS.2

Microsoft
by Microsoft

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.

TRELLIS.2
Image to 3D

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"
  }
}
Response
{
  "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"
      }
    ]
  }
}
Image to 3D

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"
  }
}
Response
{
  "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"
      }
    ]
  }
}
Image to 3D

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"
  }
}
Response
{
  "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"
      }
    ]
  }
}
Image to 3D

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"
  }
}
Response
{
  "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"
      }
    ]
  }
}