{"version":"1","model":{"id":"fal-ai/meshy/v7/image-to-3d","name":"Meshy-7 Image → 3D","kind":"3d","availability":"available","available":true,"restricted":false,"api_key_only":false,"description":"Meshy 7 image-to-3D with higher-fidelity geometry, optional Ultra detail, PBR texturing up to 8K, and production-ready GLB output.","pricing_note":"20 Meshy credits without texture; 30 at 2K/4K, 35 at 8K, plus 5 for Ultra.","categories":["i3d"],"prompt_required":false,"prompt_supported":false,"supports":{"referenceImage":true},"requires":{"referenceImage":true},"aspect_ratios":["1:1"],"resolutions":["1024"],"durations":[],"max_reference_images":1,"base_credits":53,"api_gross_margin_percent":20,"added_at":"2026-08-10","popularity_rank":448,"preview":{"image":"/meshy-7-image-to-3d-preview-v2.webp"},"schema_url":"/api/v1/models?id=fal-ai%2Fmeshy%2Fv7%2Fimage-to-3d","input_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fmeshy%2Fv7%2Fimage-to-3d","title":"Meshy-7 Image → 3D generation request","description":"Request body accepted by POST /api/v1/generate for fal-ai/meshy/v7/image-to-3d.","type":"object","properties":{"model_id":{"type":"string","const":"fal-ai/meshy/v7/image-to-3d","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"},"ultra_mode":{"title":"Ultra Geometry","description":"Add Meshy 7 Ultra generation for finer surface detail and higher-fidelity geometry.","default":false,"type":"boolean"},"should_texture":{"title":"Texture","description":"Generate base-color textures. Turn off for a geometry-only result.","default":true,"type":"boolean"},"texture_resolution":{"title":"Texture Resolution","description":"Base-color texture resolution. 8K has a higher generation price.","default":"2k","type":"string","enum":["2k","4k","8k"]},"enable_pbr":{"title":"Enable PBR","description":"Generate metallic, roughness, and normal maps. Meshy 7 does not produce an emission map.","default":false,"type":"boolean"},"texture_prompt":{"title":"Texture Prompt","description":"Optional material or appearance guidance. Takes priority over a texture guide image.","type":"string"},"texture_image_url":{"title":"Texture Guide Image","description":"Optional JPG or PNG image used to guide texturing.","type":"string"},"should_remesh":{"title":"Remesh","description":"Remesh and decimate the result. Leave off for Meshy 7's highest-fidelity geometry.","default":false,"type":"boolean"},"topology":{"title":"Remesh Topology","description":"Topology used only when Remesh is enabled.","default":"triangle","type":"string","enum":["triangle","quad"]},"decimation_mode":{"title":"Adaptive Decimation","description":"Adaptive face-count level. When selected it overrides Target Face Count.","default":"","type":"string","enum":["","1","2","3","4"]},"target_polycount":{"title":"Target Face Count","description":"Approximate face count when Remesh is enabled and adaptive decimation is off.","default":30000,"type":"number","minimum":100,"maximum":300000,"multipleOf":100},"pose_mode":{"title":"Pose Mode","description":"Request an A-pose or T-pose for character inputs.","default":"","type":"string","enum":["","a-pose","t-pose"]},"image_enhancement":{"title":"Image Enhancement","description":"Optimize the input image for better reconstruction. Turn off to preserve its exact appearance.","default":true,"type":"boolean"},"auto_size":{"title":"Auto Size","description":"Estimate the object's real-world height and scale the model automatically.","default":false,"type":"boolean"},"origin_at":{"title":"Origin","description":"Origin position when Auto Size is enabled.","default":"bottom","type":"string","enum":["bottom","center"]},"aspect_ratio":{"type":"string","enum":["1:1"]},"resolution":{"type":"string","enum":["1024"]},"reference_image_url":{"type":"string","format":"uri"}},"required":["model_id","reference_image_url"],"additionalProperties":false},"parameters":[{"key":"ultra_mode","label":"Ultra Geometry","type":"toggle","default":false,"description":"Add Meshy 7 Ultra generation for finer surface detail and higher-fidelity geometry."},{"key":"should_texture","label":"Texture","type":"toggle","default":true,"description":"Generate base-color textures. Turn off for a geometry-only result."},{"key":"texture_resolution","label":"Texture Resolution","type":"select","default":"2k","options":["2k","4k","8k"],"description":"Base-color texture resolution. 8K has a higher generation price."},{"key":"enable_pbr","label":"Enable PBR","type":"toggle","default":false,"description":"Generate metallic, roughness, and normal maps. Meshy 7 does not produce an emission map."},{"key":"texture_prompt","label":"Texture Prompt","type":"text","description":"Optional material or appearance guidance. Takes priority over a texture guide image."},{"key":"texture_image_url","label":"Texture Guide Image","type":"text","description":"Optional JPG or PNG image used to guide texturing."},{"key":"should_remesh","label":"Remesh","type":"toggle","default":false,"description":"Remesh and decimate the result. Leave off for Meshy 7's highest-fidelity geometry."},{"key":"topology","label":"Remesh Topology","type":"select","default":"triangle","options":["triangle","quad"],"description":"Topology used only when Remesh is enabled."},{"key":"decimation_mode","label":"Adaptive Decimation","type":"select","default":"","options":["","1","2","3","4"],"description":"Adaptive face-count level. When selected it overrides Target Face Count."},{"key":"target_polycount","label":"Target Face Count","type":"number","default":30000,"min":100,"max":300000,"step":100,"description":"Approximate face count when Remesh is enabled and adaptive decimation is off."},{"key":"pose_mode","label":"Pose Mode","type":"select","default":"","options":["","a-pose","t-pose"],"description":"Request an A-pose or T-pose for character inputs."},{"key":"image_enhancement","label":"Image Enhancement","type":"toggle","default":true,"description":"Optimize the input image for better reconstruction. Turn off to preserve its exact appearance."},{"key":"auto_size","label":"Auto Size","type":"toggle","default":false,"description":"Estimate the object's real-world height and scale the model automatically."},{"key":"origin_at","label":"Origin","type":"select","default":"bottom","options":["bottom","center"],"description":"Origin position when Auto Size is enabled."}]}}