Hyper3D - Rodin V2.5 - Text to 3D

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

{
  "type": "object",
  "required": [
    "prompt"
  ],
  "properties": {
    "material": {
      "type": "string",
      "description": "Material type. PBR: physically-based materials with realistic lighting. Shaded: baked lighting with no PBR maps. All: both PBR and Shaded variants. None: geometry only with no textures.",
      "default": "All",
      "enum": [
        "PBR",
        "Shaded",
        "All",
        "None"
      ]
    },
    "tier": {
      "type": "string",
      "description": "Generation tier. Higher tiers produce more detailed meshes. See more info in the [documentation](https://developer.hyper3d.ai/api-specification/rodin-gen2.5#use-gen-2.5-generation-with-following-gen-2.5-tiers). Selecting Gen-2.5-Minimum will automatically configure to a minimum mode, where 50K Trian",
      "default": "Gen-2.5-High",
      "enum": [
        "Gen-2.5-Minimum",
        "Gen-2.5-Extreme-Low",
        "Gen-2.5-Low",
        "Gen-2.5-Medium",
        "Gen-2.5-High",
        "Gen-2.5-Extreme-High"
      ]
    },
    "texture_delight": {
      "type": "boolean",
      "description": "Removes baked lighting/highlights from the generated textures.",
      "default": false
    },
    "enable_safety_checker": {
      "type": "boolean",
      "description": "Authorized callers may set false to request relaxed screening.",
      "default": true
    },
    "prompt": {
      "type": "string",
      "description": "A textual prompt to guide model generation. Required for Text-to-3D mode."
    },
    "seed": {
      "type": "integer",
      "description": "Seed value for randomization, ranging from 0 to 65535. Optional."
    },
    "is_micro": {
      "type": "boolean",
      "description": "Generate finer micro-scale geometric detail. Only effective with `tier=\"Gen-2.5-Extreme-High\"`.",
      "default": false
    },
    "hd_texture": {
      "type": "boolean",
      "description": "Enables enhanced texture post-processing for higher visual fidelity.",
      "default": false
    },
    "addons": {
      "type": "null",
      "description": "Optional add-ons"
    },
    "texture_mode": {
      "type": "string",
      "description": "Texture generation quality. When unset, the API picks a default appropriate for the tier.",
      "enum": [
        "legacy",
        "extreme-low",
        "low",
        "medium",
        "high"
      ]
    },
    "geometry_file_format": {
      "type": "string",
      "description": "Format of the geometry file. Possible values: glb, usdz, fbx, obj, stl. Default is glb.",
      "default": "glb",
      "enum": [
        "glb",
        "usdz",
        "fbx",
        "obj",
        "stl"
      ]
    },
    "TAPose": {
      "type": "boolean",
      "description": "Generate characters in T-pose or A-pose format, making them easier to rig and animate in 3D software.",
      "default": false
    },
    "quality_mesh_option": {
      "type": "string",
      "description": "Combined quality and mesh type selection. Quad = smooth surfaces, Triangle = detailed geometry. Maps to `mesh_mode` (Quad/Raw) and `quality_override` (face count) on the Hyper3D API. Valid face counts depend on the selected tier. Up to 1M Triangle is supported for tiers Extreme-Low, Low, and Medium.",
      "default": "Auto",
      "enum": [
        "Auto",
        "4K Quad",
        "8K Quad",
        "18K Quad",
        "50K Quad",
        "100K Quad",
        "200K Quad",
        "2K Triangle",
        "20K Triangle",
        "50K Triangle",
        "150K Triangle",
        "500K Triangle",
        "1M Triangle",
        "2M Triangle"
      ]
    },
    "bbox_condition": {
      "type": "null",
      "description": "This is a controlnet that controls the maximum sized of the generated model."
    },
    "enable_creative_mode": {
      "type": "boolean",
      "description": "If enabled, the generation will have enhanced generative robustness while ensuring output consistency. This corresponds to `geometry_instruct_mode` being equal to `creative` on the Hyper3D API.",
      "default": false
    }
  }
}