Meshy 7.1 Text to 3D

curl -X POST https://superpowers.tools/v1/run \
  -H 'Authorization: Bearer $SP_KEY' \
  -d '{"tool":"fal.meshy-v7.1-text-to-3d","input":{"prompt":""},"idempotency_key":"example-request-1"}'

{
  "type": "object",
  "required": [
    "prompt"
  ],
  "properties": {
    "should_remesh": {
      "type": "boolean",
      "description": "Whether to enable the remesh phase. When false, returns unprocessed triangular mesh.",
      "default": true
    },
    "model_type": {
      "type": "string",
      "description": "Type of 3D mesh generation. 'standard' produces a regular high-detail mesh; 'lowpoly' produces a low-poly mesh optimized for cleaner polygons; 'smart-topology' uses Meshy-T2 for clean, natively separated parts on the geometry (preview) step. When set to 'lowpoly', the remesh controls (topology, targ",
      "default": "standard",
      "enum": [
        "standard",
        "lowpoly",
        "smart-topology"
      ]
    },
    "texture_image_url": {
      "type": "string",
      "description": "2D image to guide the texturing process (only used in 'full' mode)"
    },
    "seed": {
      "type": "integer",
      "description": "Seed for reproducible results. Same prompt and seed usually generate the same result."
    },
    "is_a_t_pose": {
      "type": "boolean",
      "description": "Deprecated: use pose_mode instead. When true, generates a T-pose model.",
      "default": false
    },
    "enable_animation": {
      "type": "boolean",
      "description": "Apply an animation preset to the rigged model. Requires enable_rigging to be true.",
      "default": false
    },
    "prompt": {
      "type": "string",
      "description": "Describe what kind of object the 3D model is. Maximum 600 characters."
    },
    "target_polycount": {
      "type": "integer",
      "description": "Target number of polygons in the generated model. When model_type is 'smart-topology' and this is left unset, Meshy's lower smart-topology default (4,000) is used instead; smart topology accepts at most 15,000.",
      "default": 30000
    },
    "animation_action_id": {
      "type": "integer",
      "description": "Animation preset ID from Meshy's library. Only used when enable_animation is true; in that case it must be in [0, 696] (``0`` is the \"Idle\" preset) and is otherwise rejected with a 422. See https://docs.meshy.ai/en/api/animation-library for available action IDs.",
      "default": 92
    },
    "geometry_resolution": {
      "type": "string",
      "description": "Geometry resolution. 4k is only available with Meshy-7.1.",
      "enum": [
        "standard",
        "2k",
        "4k"
      ]
    },
    "rigging_height_meters": {
      "type": "number",
      "description": "Approximate height of the character in meters. Only used when enable_rigging is true.",
      "default": 1.7
    },
    "pose_mode": {
      "type": "string",
      "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": "",
      "enum": [
        "a-pose",
        "t-pose",
        ""
      ]
    },
    "symmetry_mode": {
      "type": "string",
      "description": "Controls symmetry behavior during model generation.",
      "default": "auto",
      "enum": [
        "off",
        "auto",
        "on"
      ]
    },
    "enable_safety_checker": {
      "type": "boolean",
      "description": "If set to true, input data will be checked for safety before processing.",
      "default": true
    },
    "mode": {
      "type": "string",
      "description": "Generation mode. 'preview' returns untextured geometry only, 'full' returns textured model (preview + refine).",
      "default": "full",
      "enum": [
        "preview",
        "full"
      ]
    },
    "enable_pbr": {
      "type": "boolean",
      "description": "Generate PBR Maps (metallic, roughness, normal) in addition to base color.",
      "default": false
    },
    "ultra_mode": {
      "type": "boolean",
      "description": "Deprecated: use geometry_resolution='2k'. If both fields are provided, geometry_resolution takes precedence.",
      "default": false
    },
    "enable_rigging": {
      "type": "boolean",
      "description": "Automatically rig the generated model as a humanoid character. Includes basic walking and running animations. Best results with humanoid characters that have clearly defined limbs.",
      "default": false
    },
    "topology": {
      "type": "string",
      "description": "Specify the topology of the generated model. Quad for smooth surfaces, Triangle for detailed geometry.",
      "default": "triangle",
      "enum": [
        "quad",
        "triangle"
      ]
    },
    "texture_prompt": {
      "type": "string",
      "description": "Additional text prompt to guide the texturing process (only used in 'full' mode)"
    },
    "enable_prompt_expansion": {
      "type": "boolean",
      "description": "Whether to enable prompt expansion. This will use a large language model to expand the prompt with additional details while maintaining the original meaning.",
      "default": false
    }
  }
}