Trellis 2 Retexture

Credit-based pricing. Supports reference images.

Try Trellis 2 Retexture →Compare models

Output

3D mesh

Resolution

512, 1024

Inputs

Reference image (required)

Example prompt

A glowing runic stone totem covered in ancient moss, with golden light emanating from carved symbols

Try this prompt →

LLM-ready

API & LLM schema

Exact request contract for this model. Agents can fetch it from /api/v1/models?id=fal-ai/trellis-2/retexture.

POST/api/v1/generate17 fields · 3 required

Field	Type	Requirement	Contract
`model_id`	constant	Required	ArtEmotion model identifier.
`extra`	object	Optional	Model-specific settings may also be nested here.
`max_credits`	number	Optional	Reject before submission if the estimated list price exceeds this cap. · Range: 1–…
`webhook_url`	string	Optional	Format: uri
`webhook_secret`	string	Optional	Optional model input.
`folder_id`	string	Optional	Optional model input.
`tex_slat_sampling_steps`	number	Optional	Number of denoising steps for texture generation. More steps = slower but potentially cleaner textures. · Default: 12 · Range: 1–50
`tex_slat_guidance_strength`	number	Optional	How closely the texture follows the input image colors. · Default: 1 · Range: 0–10
`tex_slat_guidance_rescale`	number	Optional	Dampens artifacts from high guidance in the texture stage. · Default: 0 · Range: 0–1
`tex_slat_rescale_t`	number	Optional	Controls noise schedule sharpness for texture generation. · Default: 3 · Range: 1–6
`tex_slat_guidance_interval_start`	number	Optional	Fraction of denoising at which guidance starts for the texture stage. · Default: 0.6 · Range: 0–1
`tex_slat_guidance_interval_end`	number	Optional	Fraction of denoising at which guidance ends for the texture stage. · Default: 0.9 · Range: 0–1
`resolution`	string	Optional	Internal resolution for texture generation. Higher produces finer details but is slower. · Allowed: 512, 1024 · Default: 1024
`texture_size`	number	Optional	Resolution of the texture image baked onto the mesh. · Allowed: 1024, 2048, 4096 · Default: 2048
`mesh_url`	string	Required	URL of the untextured 3D mesh to retexture. Supports GLB, OBJ, PLY, and STL formats.
`seed`	integer	Optional	Random seed for reproducibility.
`reference_image_url`	string	Required	Format: uri

Minimal request example

{
  "model_id": "fal-ai/trellis-2/retexture",
  "mesh_url": "your_mesh_url",
  "reference_image_url": "https://example.com/reference_image"
}

Raw JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Ftrellis-2%2Fretexture",
  "title": "Trellis 2 Retexture generation request",
  "description": "Request body accepted by POST /api/v1/generate for fal-ai/trellis-2/retexture.",
  "type": "object",
  "properties": {
    "model_id": {
      "type": "string",
      "const": "fal-ai/trellis-2/retexture",
      "description": "ArtEmotion model identifier."
    },
    "extra": {
      "type": "object",
      "additionalProperties": true,
      "description": "Model-specific settings may also be nested here."
    },
    "max_credits": {
      "type": "number",
      "minimum": 1,
      "description": "Reject before submission if the estimated list price exceeds this cap."
    },
    "webhook_url": {
      "type": "string",
      "format": "uri",
      "maxLength": 2048
    },
    "webhook_secret": {
      "type": "string",
      "maxLength": 512
    },
    "folder_id": {
      "type": "string"
    },
    "tex_slat_sampling_steps": {
      "title": "Texture Steps",
      "description": "Number of denoising steps for texture generation. More steps = slower but potentially cleaner textures.",
      "default": 12,
      "type": "number",
      "minimum": 1,
      "maximum": 50,
      "multipleOf": 1
    },
    "tex_slat_guidance_strength": {
      "title": "Texture Guidance",
      "description": "How closely the texture follows the input image colors.",
      "default": 1,
      "type": "number",
      "minimum": 0,
      "maximum": 10
    },
    "tex_slat_guidance_rescale": {
      "title": "Texture Guidance Rescale",
      "description": "Dampens artifacts from high guidance in the texture stage.",
      "default": 0,
      "type": "number",
      "minimum": 0,
      "maximum": 1
    },
    "tex_slat_rescale_t": {
      "title": "Texture Rescale T",
      "description": "Controls noise schedule sharpness for texture generation.",
      "default": 3,
      "type": "number",
      "minimum": 1,
      "maximum": 6
    },
    "tex_slat_guidance_interval_start": {
      "title": "Texture Guidance Start",
      "description": "Fraction of denoising at which guidance starts for the texture stage.",
      "default": 0.6,
      "type": "number",
      "minimum": 0,
      "maximum": 1
    },
    "tex_slat_guidance_interval_end": {
      "title": "Texture Guidance End",
      "description": "Fraction of denoising at which guidance ends for the texture stage.",
      "default": 0.9,
      "type": "number",
      "minimum": 0,
      "maximum": 1
    },
    "resolution": {
      "title": "Resolution",
      "description": "Internal resolution for texture generation. Higher produces finer details but is slower.",
      "default": 1024,
      "type": "string",
      "enum": [
        "512",
        "1024"
      ]
    },
    "texture_size": {
      "title": "Texture Size",
      "description": "Resolution of the texture image baked onto the mesh.",
      "default": 2048,
      "type": "number",
      "enum": [
        1024,
        2048,
        4096
      ]
    },
    "mesh_url": {
      "title": "Mesh URL",
      "description": "URL of the untextured 3D mesh to retexture. Supports GLB, OBJ, PLY, and STL formats.",
      "type": "string"
    },
    "seed": {
      "title": "Seed",
      "description": "Random seed for reproducibility.",
      "type": "integer"
    },
    "reference_image_url": {
      "type": "string",
      "format": "uri"
    }
  },
  "required": [
    "model_id",
    "mesh_url",
    "reference_image_url"
  ],
  "additionalProperties": false
}

Browse schemas for every ArtEmotion model →

FAQ

How much does Trellis 2 Retexture cost on ArtEmotion?

Credit-based pricing. You pay in ArtEmotion credits — every plan and top-up converts USD to credits at a fixed rate.

Do I get my credits back if Trellis 2 Retexture fails?

Yes — failed generations are never charged. The credits are released back to your balance automatically.

Can I call Trellis 2 Retexture from the API?

Yes. Use POST /api/v1/generate with model_id: "fal-ai/trellis-2/retexture". See the API reference for the full schema.

Where are my generations stored?

Every output is saved to your personal Library. You can export or delete everything any time from Privacy & deletion.

Ready to generate with Trellis 2 Retexture?

Start now →

No commitment. New accounts get 50 free credits on signup. See pricing.