Skip to main content
ArtEmotion
3D

Meshy-7 Multi-Image → 3D

Credit-based pricing. Supports reference images.

Meshy-7 Multi-Image → 3D preview
Output
3D mesh
Aspect ratio
1:1
Resolution
1024

Inputs

  • Reference image (required)
LLM-ready

API & LLM schema

Exact request contract for this model. Agents can fetch it from /api/v1/models?id=fal-ai/meshy/v7/multi-image-to-3d.

POST/api/v1/generate23 fields · 2 required
FieldTypeRequirementContract
model_idconstantRequiredArtEmotion model identifier.
extraobjectOptionalModel-specific settings may also be nested here.
max_creditsnumberOptionalReject before submission if the estimated list price exceeds this cap. · Range: 1–…
webhook_urlstringOptionalFormat: uri
webhook_secretstringOptionalOptional model input.
folder_idstringOptionalOptional model input.
should_texturebooleanOptionalGenerate base-color textures. Turn off for a geometry-only result. · Default: true
texture_resolutionstringOptionalBase-color texture resolution. 8K has a higher generation price. · Allowed: 2k, 4k, 8k · Default: 2k
enable_pbrbooleanOptionalGenerate metallic, roughness, and normal maps. Meshy 7 does not produce an emission map. · Default: false
texture_promptstringOptionalOptional material or appearance guidance. Takes priority over a texture guide image.
texture_image_urlstringOptionalOptional JPG or PNG image used to guide texturing.
should_remeshbooleanOptionalRemesh and decimate the result. Leave off for the highest-fidelity geometry. · Default: false
topologystringOptionalTopology used only when Remesh is enabled. · Allowed: triangle, quad · Default: triangle
decimation_modestringOptionalAdaptive face-count level. When selected it overrides Target Face Count. · Allowed: , 1, 2, 3, 4 · Default:
target_polycountnumberOptionalApproximate face count when Remesh is enabled and adaptive decimation is off. · Default: 30000 · Range: 100–300000
pose_modestringOptionalRequest an A-pose or T-pose for character inputs. · Allowed: , a-pose, t-pose · Default:
image_enhancementbooleanOptionalOptimize input views for reconstruction. Turn off to preserve their exact appearance. · Default: true
remove_lightingbooleanOptionalRemove baked highlights and shadows for textures that can be relit cleanly. · Default: true
auto_sizebooleanOptionalEstimate the object's real-world height and scale the model automatically. · Default: false
origin_atstringOptionalOrigin position when Auto Size is enabled. · Allowed: bottom, center · Default: bottom
aspect_ratiostringOptionalAllowed: 1:1
resolutionstringOptionalAllowed: 1024
reference_image_urlsarray<string>RequiredItems: 1–4
Minimal request example
{
  "model_id": "fal-ai/meshy/v7/multi-image-to-3d",
  "reference_image_urls": []
}
Raw JSON Schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fmeshy%2Fv7%2Fmulti-image-to-3d",
  "title": "Meshy-7 Multi-Image → 3D generation request",
  "description": "Request body accepted by POST /api/v1/generate for fal-ai/meshy/v7/multi-image-to-3d.",
  "type": "object",
  "properties": {
    "model_id": {
      "type": "string",
      "const": "fal-ai/meshy/v7/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"
    },
    "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 the 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 input views for reconstruction. Turn off to preserve their exact appearance.",
      "default": true,
      "type": "boolean"
    },
    "remove_lighting": {
      "title": "Remove Lighting",
      "description": "Remove baked highlights and shadows for textures that can be relit cleanly.",
      "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_urls": {
      "type": "array",
      "items": {
        "type": "string",
        "format": "uri"
      },
      "minItems": 1,
      "maxItems": 4
    }
  },
  "required": [
    "model_id",
    "reference_image_urls"
  ],
  "additionalProperties": false
}

FAQ

How much does Meshy-7 Multi-Image → 3D 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 Meshy-7 Multi-Image → 3D fails?

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

Can I call Meshy-7 Multi-Image → 3D from the API?

Yes. Use POST /api/v1/generate with model_id: "fal-ai/meshy/v7/multi-image-to-3d". 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 Meshy-7 Multi-Image → 3D?

Start now →

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