fire/trellis:cd11df34 – Run with an API on Replicate

Version

You're looking at a specific version of this model. Jump to the model overview.

fire /trellis:cd11df34

Playground API

Input

image

*file

Input image to generate 3D asset from

seed

integer

Random seed for generation

Default: 0

randomize_seed

boolean

Randomize seed

Default: true

generate_color

boolean

Generate color video render

Default: false

generate_normal

boolean

Generate normal video render

Default: false

generate_model

boolean

Generate 3D model file (GLB)

Default: true

ss_guidance_strength

number

(minimum: 0, maximum: 10)

Stage 1: Sparse Structure Generation - Guidance Strength

Default: 7.5

ss_sampling_steps

integer

(minimum: 1, maximum: 50)

Stage 1: Sparse Structure Generation - Sampling Steps

Default: 12

slat_guidance_strength

number

(minimum: 0, maximum: 10)

Stage 2: Structured Latent Generation - Guidance Strength

Default: 3

slat_sampling_steps

integer

(minimum: 1, maximum: 50)

Stage 2: Structured Latent Generation - Sampling Steps

Default: 12

mesh_simplify

number

(minimum: 0, maximum: 0.98)

GLB Extraction - Mesh Simplification (only used if generate_model=True)

Default: 0.65

texture_size

integer

(minimum: 512, maximum: 2048)

GLB Extraction - Texture Size (only used if generate_model=True)

Default: 512

Run this model in Node.js with one line of code:

npx create-replicate --model=fire/trellis

or set up a project from scratch

Install Replicate’s Node.js client library:

npm install replicate

Set the REPLICATE_API_TOKEN environment variable:

export REPLICATE_API_TOKEN=<paste-your-token-here>

Find your API token in your account settings.

Import and set up the client:

import Replicate from "replicate";

const replicate = new Replicate({
  auth: process.env.REPLICATE_API_TOKEN,
});

Run fire/trellis using Replicate’s API. Check out the model's schema for an overview of inputs and outputs.

const output = await replicate.run(
  "fire/trellis:cd11df34ec15a381626029d97256bf071644c24e3f6d96cb0ab09fa7d62891d2",
  {
    input: {
      seed: 0,
      texture_size: 512,
      mesh_simplify: 0.65,
      generate_color: false,
      generate_model: true,
      randomize_seed: true,
      generate_normal: false,
      ss_sampling_steps: 12,
      slat_sampling_steps: 12,
      ss_guidance_strength: 7.5,
      slat_guidance_strength: 3
    }
  }
);
console.log(output);

To learn more, take a look at the guide on getting started with Node.js.

Install Replicate’s Python client library:

pip install replicate

Set the REPLICATE_API_TOKEN environment variable:

export REPLICATE_API_TOKEN=<paste-your-token-here>

Find your API token in your account settings.

Import the client:

import replicate

Run fire/trellis using Replicate’s API. Check out the model's schema for an overview of inputs and outputs.

output = replicate.run(
    "fire/trellis:cd11df34ec15a381626029d97256bf071644c24e3f6d96cb0ab09fa7d62891d2",
    input={
        "seed": 0,
        "texture_size": 512,
        "mesh_simplify": 0.65,
        "generate_color": False,
        "generate_model": True,
        "randomize_seed": True,
        "generate_normal": False,
        "ss_sampling_steps": 12,
        "slat_sampling_steps": 12,
        "ss_guidance_strength": 7.5,
        "slat_guidance_strength": 3
    }
)
print(output)

To learn more, take a look at the guide on getting started with Python.

Set the REPLICATE_API_TOKEN environment variable:

export REPLICATE_API_TOKEN=<paste-your-token-here>

Find your API token in your account settings.

Run fire/trellis using Replicate’s API. Check out the model's schema for an overview of inputs and outputs.

curl -s -X POST \
  -H "Authorization: Bearer $REPLICATE_API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Prefer: wait" \
  -d $'{
    "version": "cd11df34ec15a381626029d97256bf071644c24e3f6d96cb0ab09fa7d62891d2",
    "input": {
      "seed": 0,
      "texture_size": 512,
      "mesh_simplify": 0.65,
      "generate_color": false,
      "generate_model": true,
      "randomize_seed": true,
      "generate_normal": false,
      "ss_sampling_steps": 12,
      "slat_sampling_steps": 12,
      "ss_guidance_strength": 7.5,
      "slat_guidance_strength": 3
    }
  }' \
  https://api.replicate.com/v1/predictions

To learn more, take a look at Replicate’s HTTP API reference docs.

Output

No output yet! Press "Submit" to start a prediction.