{"version":"1","model":{"id":"fal-ai/trellis-2","name":"Trellis 2","kind":"3d","availability":"available","available":true,"restricted":false,"api_key_only":false,"description":"Advanced image-to-3D model with three-stage pipeline (structure, shape, texture), UV unwrapping, and full pipeline controls for high-quality GLB export.","pricing_note":"$0.30 per generation.","categories":["i3d"],"prompt_required":false,"prompt_supported":false,"supports":{"referenceImage":true},"requires":{"referenceImage":true},"aspect_ratios":[],"resolutions":["512","1024","1536"],"durations":[],"max_reference_images":1,"base_credits":38,"api_gross_margin_percent":20,"added_at":"2026-06-01","popularity_rank":444,"preview":{"image":"/images/model-previews/generated/trellis-2-v1.webp"},"schema_url":"/api/v1/models?id=fal-ai%2Ftrellis-2","input_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://www.artemotion.ai/api/v1/models?id=fal-ai%2Ftrellis-2","title":"Trellis 2 generation request","description":"Request body accepted by POST /api/v1/generate for fal-ai/trellis-2.","type":"object","properties":{"model_id":{"type":"string","const":"fal-ai/trellis-2","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"},"ss_sampling_steps":{"title":"Structure Steps","description":"Number of denoising steps for the initial structure. More steps = slower but potentially higher quality.","default":12,"type":"number","minimum":1,"maximum":50,"multipleOf":1},"ss_guidance_strength":{"title":"Structure Guidance","description":"How closely the initial 3D structure follows the input image.","default":7.5,"type":"number","minimum":0,"maximum":10},"ss_guidance_rescale":{"title":"Structure Guidance Rescale","description":"Dampens artifacts from high guidance in stage 1.","default":0.7,"type":"number","minimum":0,"maximum":1},"ss_rescale_t":{"title":"Structure Rescale T","description":"Controls noise schedule sharpness for structure generation.","default":5,"type":"number","minimum":1,"maximum":6},"ss_guidance_interval_start":{"title":"Structure Guidance Start","description":"Fraction of denoising at which guidance starts for stage 1.","default":0.6,"type":"number","minimum":0,"maximum":1},"ss_guidance_interval_end":{"title":"Structure Guidance End","description":"Fraction of denoising at which guidance ends for stage 1.","default":1,"type":"number","minimum":0,"maximum":1},"shape_slat_sampling_steps":{"title":"Shape Steps","description":"Number of denoising steps for shape refinement. More steps = slower but potentially smoother geometry.","default":12,"type":"number","minimum":1,"maximum":50,"multipleOf":1},"shape_slat_guidance_strength":{"title":"Shape Guidance","description":"How closely the detailed geometry follows the input image.","default":7.5,"type":"number","minimum":0,"maximum":10},"shape_slat_guidance_rescale":{"title":"Shape Guidance Rescale","description":"Dampens artifacts from high guidance in the shape stage.","default":0.5,"type":"number","minimum":0,"maximum":1},"shape_slat_rescale_t":{"title":"Shape Rescale T","description":"Controls noise schedule sharpness for shape refinement.","default":3,"type":"number","minimum":1,"maximum":6},"shape_slat_guidance_interval_start":{"title":"Shape Guidance Start","description":"Fraction of denoising at which guidance starts for stage 2.","default":0.6,"type":"number","minimum":0,"maximum":1},"shape_slat_guidance_interval_end":{"title":"Shape Guidance End","description":"Fraction of denoising at which guidance ends for stage 2.","default":1,"type":"number","minimum":0,"maximum":1},"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 stage 3.","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 stage 3.","default":0.9,"type":"number","minimum":0,"maximum":1},"resolution":{"title":"Resolution","description":"Output resolution; higher is slower but more detailed.","default":1024,"type":"string","enum":["512","1024","1536"]},"texture_size":{"title":"Texture Size","description":"Resolution of the texture image baked onto the mesh.","default":2048,"type":"number","enum":[1024,2048,4096]},"decimation_target":{"title":"Decimation Target","description":"Target number of vertices in the final mesh. Lower = smaller files, less detail.","default":500000,"type":"number","minimum":5000,"maximum":2000000,"multipleOf":1},"remesh":{"title":"Remesh","description":"Rebuild the mesh topology for cleaner triangles.","default":true,"type":"boolean"},"remesh_band":{"title":"Remesh Band","description":"Controls how far remeshing can move vertices from the original surface.","default":1,"type":"number","minimum":0,"maximum":4},"remesh_project":{"title":"Remesh Project","description":"How much to project remeshed vertices back onto the original surface. 0 = smoother, 1 = preserves detail.","default":0,"type":"number","minimum":0,"maximum":1},"uv_unwrap_angle_threshold_deg":{"title":"UV Angle Threshold","description":"Maximum angle between adjacent face normals within a single UV chart.","default":90,"type":"number","minimum":0,"maximum":180},"uv_unwrap_global_iterations":{"title":"UV Global Iterations","description":"Number of global clustering passes during UV chart computation.","default":1,"type":"number","minimum":1,"maximum":10,"multipleOf":1},"uv_unwrap_refine_iterations":{"title":"UV Refine Iterations","description":"Number of local refinement passes during UV chart computation.","default":0,"type":"number","minimum":0,"maximum":10,"multipleOf":1},"uv_unwrap_smooth_strength":{"title":"UV Smooth Strength","description":"Smoothing strength applied to UV chart boundaries.","default":1,"type":"number","minimum":0,"maximum":10},"seed":{"title":"Seed","description":"Random seed for reproducibility.","type":"integer"},"reference_image_url":{"type":"string","format":"uri"}},"required":["model_id","reference_image_url"],"additionalProperties":false},"parameters":[{"key":"ss_sampling_steps","label":"Structure Steps","type":"number","default":12,"min":1,"max":50,"step":1,"description":"Number of denoising steps for the initial structure. More steps = slower but potentially higher quality."},{"key":"ss_guidance_strength","label":"Structure Guidance","type":"number","default":7.5,"min":0,"max":10,"description":"How closely the initial 3D structure follows the input image."},{"key":"ss_guidance_rescale","label":"Structure Guidance Rescale","type":"number","default":0.7,"min":0,"max":1,"description":"Dampens artifacts from high guidance in stage 1."},{"key":"ss_rescale_t","label":"Structure Rescale T","type":"number","default":5,"min":1,"max":6,"description":"Controls noise schedule sharpness for structure generation."},{"key":"ss_guidance_interval_start","label":"Structure Guidance Start","type":"number","default":0.6,"min":0,"max":1,"description":"Fraction of denoising at which guidance starts for stage 1."},{"key":"ss_guidance_interval_end","label":"Structure Guidance End","type":"number","default":1,"min":0,"max":1,"description":"Fraction of denoising at which guidance ends for stage 1."},{"key":"shape_slat_sampling_steps","label":"Shape Steps","type":"number","default":12,"min":1,"max":50,"step":1,"description":"Number of denoising steps for shape refinement. More steps = slower but potentially smoother geometry."},{"key":"shape_slat_guidance_strength","label":"Shape Guidance","type":"number","default":7.5,"min":0,"max":10,"description":"How closely the detailed geometry follows the input image."},{"key":"shape_slat_guidance_rescale","label":"Shape Guidance Rescale","type":"number","default":0.5,"min":0,"max":1,"description":"Dampens artifacts from high guidance in the shape stage."},{"key":"shape_slat_rescale_t","label":"Shape Rescale T","type":"number","default":3,"min":1,"max":6,"description":"Controls noise schedule sharpness for shape refinement."},{"key":"shape_slat_guidance_interval_start","label":"Shape Guidance Start","type":"number","default":0.6,"min":0,"max":1,"description":"Fraction of denoising at which guidance starts for stage 2."},{"key":"shape_slat_guidance_interval_end","label":"Shape Guidance End","type":"number","default":1,"min":0,"max":1,"description":"Fraction of denoising at which guidance ends for stage 2."},{"key":"tex_slat_sampling_steps","label":"Texture Steps","type":"number","default":12,"min":1,"max":50,"step":1,"description":"Number of denoising steps for texture generation. More steps = slower but potentially cleaner textures."},{"key":"tex_slat_guidance_strength","label":"Texture Guidance","type":"number","default":1,"min":0,"max":10,"description":"How closely the texture follows the input image colors."},{"key":"tex_slat_guidance_rescale","label":"Texture Guidance Rescale","type":"number","default":0,"min":0,"max":1,"description":"Dampens artifacts from high guidance in the texture stage."},{"key":"tex_slat_rescale_t","label":"Texture Rescale T","type":"number","default":3,"min":1,"max":6,"description":"Controls noise schedule sharpness for texture generation."},{"key":"tex_slat_guidance_interval_start","label":"Texture Guidance Start","type":"number","default":0.6,"min":0,"max":1,"description":"Fraction of denoising at which guidance starts for stage 3."},{"key":"tex_slat_guidance_interval_end","label":"Texture Guidance End","type":"number","default":0.9,"min":0,"max":1,"description":"Fraction of denoising at which guidance ends for stage 3."},{"key":"resolution","label":"Resolution","type":"select","default":1024,"options":["512","1024","1536"],"description":"Output resolution; higher is slower but more detailed."},{"key":"texture_size","label":"Texture Size","type":"select","default":2048,"options":["1024","2048","4096"],"description":"Resolution of the texture image baked onto the mesh."},{"key":"decimation_target","label":"Decimation Target","type":"number","default":500000,"min":5000,"max":2000000,"step":1,"description":"Target number of vertices in the final mesh. Lower = smaller files, less detail."},{"key":"remesh","label":"Remesh","type":"toggle","default":true,"description":"Rebuild the mesh topology for cleaner triangles."},{"key":"remesh_band","label":"Remesh Band","type":"number","default":1,"min":0,"max":4,"description":"Controls how far remeshing can move vertices from the original surface."},{"key":"remesh_project","label":"Remesh Project","type":"number","default":0,"min":0,"max":1,"description":"How much to project remeshed vertices back onto the original surface. 0 = smoother, 1 = preserves detail."},{"key":"uv_unwrap_angle_threshold_deg","label":"UV Angle Threshold","type":"number","default":90,"min":0,"max":180,"description":"Maximum angle between adjacent face normals within a single UV chart."},{"key":"uv_unwrap_global_iterations","label":"UV Global Iterations","type":"number","default":1,"min":1,"max":10,"step":1,"description":"Number of global clustering passes during UV chart computation."},{"key":"uv_unwrap_refine_iterations","label":"UV Refine Iterations","type":"number","default":0,"min":0,"max":10,"step":1,"description":"Number of local refinement passes during UV chart computation."},{"key":"uv_unwrap_smooth_strength","label":"UV Smooth Strength","type":"number","default":1,"min":0,"max":10,"description":"Smoothing strength applied to UV chart boundaries."},{"key":"seed","label":"Seed","type":"seed","description":"Random seed for reproducibility."}]}}