trellis/trellis-2/retexture

Name: Trellis 2
Author: trellis

Trellis 2 Retexture is trellis's image-to-3D AI model. Transform photographs into production-ready 3D meshes with accurate geometry and texture mapping.

Input

Image URL or upload(string)

Upload

PNG, JPEG, WebP, or GIF · 20 MiB maximum

URL of the reference image for texturing

This field is required.

Resolution(integer)

Internal resolution for texture generation. Higher produces finer texture details but is slower. Allowed values: 512, 1024.

Tex Slat Guidance Strength(number)

010

How closely the texture follows the input image colors. Higher values produce more vivid but potentially oversaturated textures. Range: 0 to 10.

Tex Slat Sampling Steps(integer)

150

Number of denoising steps for texture generation. More steps = slower but potentially cleaner textures. Range: 1 to 50.

Tex Slat Guidance Interval End(number)

Fraction of the denoising process at which classifier-free guidance ends for the texture stage. Must be >= tex_slat_guidance_interval_start. Range: 0 to 1.

Tex Slat Guidance Rescale(number)

Dampens artifacts from high guidance in the texture stage. Increase if textures look noisy or have color banding. Range: 0 to 1.

Tex Slat Guidance Interval Start(number)

Fraction of the denoising process at which classifier-free guidance starts for the texture stage. Guidance is only applied between interval_start and interval_end. Range: 0 to 1.

Tex Slat Rescale T(number)

Controls noise schedule sharpness for texture generation. Higher values produce sharper texture details. Range: 1 to 6.

Mesh Url(string)

URL of the untextured 3D mesh to retexture. Supports GLB, OBJ, PLY, and STL formats.

Texture Size(integer)

Resolution of the texture image baked onto the mesh. Higher values capture finer surface details but produce larger files. Allowed values: 1024, 2048, 4096.

Seed(integer)

Random seed for reproducibility

Idle

Example output — click Run to generate your own

Production endpoint

Send your first request

OpenAI-compatible endpoint with unified authentication and usage tracking.

POSThttps://api.sandbase.ai/v1/run

Model IDtrellis/trellis-2/retexture

Input Schema

11 parameters · 1 required · 10 optional

Parameter	Type	Required	Description
`image`	string	Required	URL of the reference image for texturing
`seed`	integer	Optional	Random seed for reproducibility
`mesh_url`	string	Optional	URL of the untextured 3D mesh to retexture. Supports GLB, OBJ, PLY, and STL formats.
`resolution`	integer	Optional	Internal resolution for texture generation. Higher produces finer texture details but is slower. · Options: 512, 1024 · Default: 1024 5121024
`texture_size`	integer	Optional	Resolution of the texture image baked onto the mesh. Higher values capture finer surface details but produce larger files. · Options: 1024, 2048, 4096 · Default: 2048 102420484096
`tex_slat_rescale_t`	number	Optional	Controls noise schedule sharpness for texture generation. Higher values produce sharper texture details. · Min: 1 · Max: 6 · Default: 3
`tex_slat_sampling_steps`	integer	Optional	Number of denoising steps for texture generation. More steps = slower but potentially cleaner textures. · Min: 1 · Max: 50 · Default: 12
`tex_slat_guidance_rescale`	number	Optional	Dampens artifacts from high guidance in the texture stage. Increase if textures look noisy or have color banding. · Min: 0 · Max: 1 · Default: 0
`tex_slat_guidance_strength`	number	Optional	How closely the texture follows the input image colors. Higher values produce more vivid but potentially oversaturated textures. · Min: 0 · Max: 10 · Default: 1
`tex_slat_guidance_interval_end`	number	Optional	Fraction of the denoising process at which classifier-free guidance ends for the texture stage. Must be >= tex_slat_guidance_interval_start. · Min: 0 · Max: 1 · Default: 0.9
`tex_slat_guidance_interval_start`	number	Optional	Fraction of the denoising process at which classifier-free guidance starts for the texture stage. Guidance is only applied between interval_start and interval_end. · Min: 0 · Max: 1 · Default: 0.6

Output Schema

Field	Type	Description
`id`	string	Unique identifier for the generation task
`status`	string	Task status: pending, running, completed, failed, timeout
`model`	string	Model used for the generation
`outputs`	array	Array of output items
`outputs[].url`	string	URL of the generated artifact
`outputs[].content_type`	string	MIME type (e.g. image/png, video/mp4)
`error`	object \| null	Error details if failed, null on success
`error.type`	string	Machine-readable error type code
`error.message`	string	Human-readable error description

Async Workflow

This model uses asynchronous execution. Submit a request and poll for the result.

Submit — POST to /v1/run, receive an id
Poll — GET /v1/run/{id} until status is completed, failed, or timeout
Retrieve — Read outputs from the completed response

Code Examples

Ready-to-run snippets

# Step 1: Submit
curl -X POST https://api.sandbase.ai/v1/run \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "model": "trellis/trellis-2/retexture",
  "image": "https://static.sandbase.ai/examples/trellis/trellis-2/retexture/input_image_1.png",
  "mesh_url": "https://raw.githubusercontent.com/KhronosGroup/glTF-Sample-Assets/main/Models/ClearCoatCarPaint/glTF-Binary/ClearCoatCarPaint.glb",
  "resolution": 1024,
  "texture_size": 2048,
  "tex_slat_rescale_t": 3,
  "tex_slat_sampling_steps": 12,
  "tex_slat_guidance_rescale": 0,
  "tex_slat_guidance_strength": 1,
  "tex_slat_guidance_interval_end": 0.9,
  "tex_slat_guidance_interval_start": 0.6,
  "prompt": "a beautiful sunset over mountains"
}'

# Step 2: Poll result (replace <id>)
curl https://api.sandbase.ai/v1/run/<id> \
  -H "Authorization: Bearer YOUR_API_KEY"

← Back to Trellis 2

API README

Trellis 2

Trellis 2 Retexture is trellis's image-to-3D AI model. Transform photographs into production-ready 3D meshes with accurate geometry and texture mapping. Trellis 2 is tailored to the trellis/trellis-2/retexture workflow for retexture work in image production. Because trellis/trellis-2/retexture is a separate catalog entry, evaluations should use this route’s own inputs, output expectations, and billing behavior. Teams can place this named operation inside review, asset preparation, and publishing pipelines while keeping the original request attached to every result. The endpoint is especially useful when a project has a defined transformation goal and needs a repeatable request contract instead of an ad-hoc desktop step. This capability boundary is specific to the endpoint named above.

seed controls random seed for reproducibility; image controls uRL of the reference image for texturing; mesh url controls uRL of the untextured 3D mesh to retexture. Supports GLB, OBJ, PLY, and STL formats; resolution controls internal resolution for texture generation. Higher produces finer texture details but is slower; resolution accepts 512, 1024; texture size controls resolution of the texture image baked onto the mesh. Higher values capture finer surface details but produce larger files; texture size accepts 1024, 2048, 4096; tex slat rescale t controls controls noise schedule sharpness for texture generation. Higher values produce sharper texture details. The mandatory portion is image. Trellis 2 exposes seed, image, mesh_url, resolution, texture_size, tex_slat_rescale_t, tex_slat_sampling_steps as its documented request surface. For example, the route documentation includes “https://static.sandbase.ai/examples/trellis/trellis-2/retexture/input_image_1.png”. Applications can submit that exact shape asynchronously, retain the chosen arguments in job metadata, and collect the resulting media URL for review or publishing.

Highlights

Geometry-preserving retexturing. Trellis 2 changes the surface appearance of an existing 3D asset while retaining its underlying form.
Reference-driven materials. Supplied visual direction guides color, pattern, and material character across the object’s surfaces.
Asset variation without remodelling. Teams can explore alternate finishes or art directions without rebuilding the mesh from scratch.
Resolution-aware texture delivery. Documented output choices support fast look development as well as higher-detail presentation passes.

Pricing

Billing option	Price
Billing formula	`params.resolution == "1024p" ? 0.24 : 0.2`
`resolution=512`	`$0.200000`
`resolution=1024`	`$0.200000`
`resolution=1024p`	`$0.240000`
Other declared resolution	`$0.200000`

When to Use

Scenario	Why it fits
Choose Trellis 2	Use it when the job specifically calls for retexture and the route’s documented input contract matches assets already available in your workflow.
Keep the request reproducible	Use the required `image` explicitly, then record optional choices alongside the prompt for repeatable reruns.
Build controlled creative variations	Change one declared control at a time when comparing framing, format, duration, resolution, style, or other route-supported output decisions.
Integrate asynchronous delivery	Use this endpoint when an application can submit work, track completion, and collect the returned media URL instead of requiring an immediate inline artifact.
Validate before a large batch	Run representative prompts and source assets first, confirm the visual or audio behavior, then lock the successful request shape for scaled production.

Prompt Guide

Lead with the subject or transformation, then add the composition, environment, style, lighting, motion, voice, or fidelity details relevant to this route. Keep every parameter inside the documented schema; the example below uses only fields declared for trellis/trellis-2/retexture.

{
  "image": "https://static.sandbase.ai/examples/trellis/trellis-2/retexture/input_image_1.png",
  "resolution": 512,
  "texture_size": 1024
}

Technical Specs

Specification	Details
Model ID	`trellis/trellis-2/retexture`
Execution mode	`async`
Task type	`image`
`seed`	`integer` · optional
`image`	`string` · required
`mesh_url`	`string` · optional
`resolution`	`integer` · optional · choices: `512`, `1024`
`texture_size`	`integer` · optional · choices: `1024`, `2048`, `4096`
`tex_slat_rescale_t`	`number` · optional · min `1` · max `6`
`tex_slat_sampling_steps`	`integer` · optional · min `1` · max `50`
`tex_slat_guidance_rescale`	`number` · optional · min `0` · max `1`
`tex_slat_guidance_strength`	`number` · optional · min `0` · max `10`
`tex_slat_guidance_interval_end`	`number` · optional · min `0` · max `1`
`tex_slat_guidance_interval_start`	`number` · optional · min `0` · max `1`