Meshy-6 Image → 3D

{
  "model_id": "fal-ai/meshy/v6/image-to-3d",
  "prompt": "Describe the result you want to create.",
  "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%2Fv6%2Fimage-to-3d",
  "title": "Meshy-6 Image → 3D generation request",
  "description": "Request body accepted by POST /api/v1/generate for fal-ai/meshy/v6/image-to-3d.",
  "type": "object",
  "properties": {
    "model_id": {
      "type": "string",
      "const": "fal-ai/meshy/v6/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. Includes basic walking and running animations. Best results with humanoid characters.",
      "default": false,
      "type": "boolean"
    },
    "pose_mode": {
      "title": "Pose Mode",
      "description": "Pose mode for the generated model. 'a-pose' generates an A-pose, 't-pose' generates a T-pose, empty string for no specific pose.",
      "default": "",
      "type": "string",
      "enum": [
        "a-pose",
        "t-pose",
        ""
      ]
    },
    "should_texture": {
      "title": "Texture",
      "description": "Whether to generate textures.",
      "default": true,
      "type": "boolean"
    },
    "texture_prompt": {
      "title": "Texture Prompt",
      "description": "Text prompt to guide the texturing process.",
      "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.",
      "default": false,
      "type": "boolean"
    },
    "hd_texture": {
      "title": "HD Texture (4K)",
      "description": "Generate 4K base color texture instead of the default 1K.",
      "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.",
      "type": "string"
    },
    "aspect_ratio": {
      "type": "string",
      "enum": [
        "1:1"
      ]
    },
    "resolution": {
      "type": "string",
      "enum": [
        "1024"
      ]
    },
    "reference_image_url": {
      "type": "string",
      "format": "uri"
    }
  },
  "required": [
    "model_id",
    "prompt",
    "reference_image_url"
  ],
  "additionalProperties": false
}