{"version":"1","model":{"id":"fal-ai/meshy/v5/multi-image-to-3d","name":"Meshy-5 Multi-Image → 3D","kind":"3d","availability":"available","available":true,"restricted":false,"api_key_only":false,"description":"Meshy v5 multi-image-to-3D — previous-generation multi-view 3D reconstruction with PBR support from up to 4 reference images.","pricing_note":"$0.21/generation at Pro plan pricing.","categories":["multi3d"],"prompt_required":true,"prompt_supported":true,"supports":{"referenceImage":true},"requires":{"referenceImage":true},"aspect_ratios":["1:1"],"resolutions":["1024"],"durations":[],"max_reference_images":4,"base_credits":27,"api_gross_margin_percent":20,"added_at":"2026-05-09","popularity_rank":455,"example_prompt":"A Nordic frost giant warrior with ice-blue skin, glacier-white braided hair, and a glowing frost-rune ice club","preview":{"image":"https://cdn.artemotion.ai/file/artemotion-ai-bckt/model-previews/3d/meshy-v5-multi-character-thumb.png"},"schema_url":"/api/v1/models?id=fal-ai%2Fmeshy%2Fv5%2Fmulti-image-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%2Fv5%2Fmulti-image-to-3d","title":"Meshy-5 Multi-Image → 3D generation request","description":"Request body accepted by POST /api/v1/generate for fal-ai/meshy/v5/multi-image-to-3d.","type":"object","properties":{"model_id":{"type":"string","const":"fal-ai/meshy/v5/multi-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"},"prompt":{"type":"string"},"enable_rigging":{"title":"Enable Rigging","description":"Automatically rig the generated model as a humanoid character.","default":false,"type":"boolean"},"pose_mode":{"title":"Pose Mode","description":"Pose mode for the generated model.","default":"","type":"string","enum":["a-pose","t-pose",""]},"should_texture":{"title":"Texture","description":"Whether to generate textures. False provides mesh without textures for 5 credits, True adds texture generation for additional 10 credits.","default":true,"type":"boolean"},"texture_prompt":{"title":"Texture Prompt","description":"Text prompt to guide the texturing process. Requires should_texture to be true.","type":"string"},"should_remesh":{"title":"Remesh","description":"Whether to enable the remesh phase.","default":true,"type":"boolean"},"topology":{"title":"Topology","description":"Mesh topology. Quad for smooth surfaces, Triangle for detailed geometry.","default":"triangle","type":"string","enum":["quad","triangle"]},"enable_animation":{"title":"Enable Animation","description":"Apply an animation preset to the rigged model. Requires enable_rigging to be true.","default":false,"type":"boolean"},"target_polycount":{"title":"Target Polycount","description":"Target number of polygons in the generated model.","default":30000,"type":"number","minimum":100,"maximum":300000,"multipleOf":1},"rigging_height_meters":{"title":"Rigging Height (m)","description":"Approximate height of the character in meters. Only used when enable_rigging is true.","default":1.7,"type":"number"},"symmetry_mode":{"title":"Symmetry Mode","description":"Controls symmetry behavior during model generation.","default":"auto","type":"string","enum":["off","auto","on"]},"animation_action_id":{"title":"Animation","description":"Select an available motion from Meshy's live library. For generation models, enable Add Animation to apply it.","default":92,"type":"integer","minimum":0,"multipleOf":1},"enable_pbr":{"title":"Enable PBR","description":"Generate PBR maps (metallic, roughness, normal) in addition to base color. Requires should_texture to be true.","default":false,"type":"boolean"},"enable_safety_checker":{"title":"Enable Safety Checker","description":"Run the input safety checker before processing.","default":true,"type":"boolean"},"texture_image_url":{"title":"Texture Guide Image","description":"2D image to guide the texturing process. Requires should_texture to be true.","type":"string"},"aspect_ratio":{"type":"string","enum":["1:1"]},"resolution":{"type":"string","enum":["1024"]},"reference_image_urls":{"type":"array","items":{"type":"string","format":"uri"},"maxItems":4}},"required":["model_id","prompt","reference_image_urls"],"additionalProperties":false},"parameters":[{"key":"enable_rigging","label":"Enable Rigging","type":"toggle","default":false,"description":"Automatically rig the generated model as a humanoid character."},{"key":"pose_mode","label":"Pose Mode","type":"select","default":"","options":["a-pose","t-pose",""],"description":"Pose mode for the generated model."},{"key":"should_texture","label":"Texture","type":"toggle","default":true,"description":"Whether to generate textures. False provides mesh without textures for 5 credits, True adds texture generation for additional 10 credits."},{"key":"texture_prompt","label":"Texture Prompt","type":"text","description":"Text prompt to guide the texturing process. Requires should_texture to be true."},{"key":"should_remesh","label":"Remesh","type":"toggle","default":true,"description":"Whether to enable the remesh phase."},{"key":"topology","label":"Topology","type":"select","default":"triangle","options":["quad","triangle"],"description":"Mesh topology. Quad for smooth surfaces, Triangle for detailed geometry."},{"key":"enable_animation","label":"Enable Animation","type":"toggle","default":false,"description":"Apply an animation preset to the rigged model. Requires enable_rigging to be true."},{"key":"target_polycount","label":"Target Polycount","type":"number","default":30000,"min":100,"max":300000,"step":1,"description":"Target number of polygons in the generated model."},{"key":"rigging_height_meters","label":"Rigging Height (m)","type":"number","default":1.7,"description":"Approximate height of the character in meters. Only used when enable_rigging is true."},{"key":"symmetry_mode","label":"Symmetry Mode","type":"select","default":"auto","options":["off","auto","on"],"description":"Controls symmetry behavior during model generation."},{"key":"animation_action_id","label":"Animation","type":"integer","default":92,"min":0,"step":1,"description":"Select an available motion from Meshy's live library. For generation models, enable Add Animation to apply it."},{"key":"enable_pbr","label":"Enable PBR","type":"toggle","default":false,"description":"Generate PBR maps (metallic, roughness, normal) in addition to base color. Requires should_texture to be true."},{"key":"enable_safety_checker","label":"Enable Safety Checker","type":"toggle","default":true,"description":"Run the input safety checker before processing."},{"key":"texture_image_url","label":"Texture Guide Image","type":"text","description":"2D image to guide the texturing process. Requires should_texture to be true."}]}}