Meshy-7 Image → 3D

{
  "model_id": "fal-ai/meshy/v7/image-to-3d",
  "reference_image_url": "https://example.com/reference_image"
}

{
  "$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
}