> ## Documentation Index
> Fetch the complete documentation index at: https://mcp-for-blender.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Hyper3D Rodin: AI-Generated 3D Models in Blender MCP

> Generate custom 3D models from text prompts or reference images using Hyper3D Rodin inside Blender MCP, then import them directly into your scene.

Hyper3D Rodin generates high-quality 3D models from a text description or a reference image. When your scene needs a custom prop that does not exist in any asset library, Rodin can create it from scratch and import it directly into Blender.

## Setup

Before you can generate models, configure your API key.

<Steps>
  <Step>
    Get an API key at [hyper3d.ai](https://hyper3d.ai).
  </Step>

  <Step>
    In Blender, press **N** in the 3D viewport and open the **BlenderMCP** tab.
  </Step>

  <Step>
    Tick **Use Hyper3D**.
  </Step>

  <Step>
    Paste your API key into the field.
  </Step>
</Steps>

To store the key permanently, go to **Edit → Preferences → Add-ons → Blender MCP** and enter it in the Hyper3D API Key field. Alternatively, set the environment variable `BLENDERMCP_HYPER3D_API_KEY` before starting Blender. You can also use a fal.ai API key if you have one.

## Generation Workflow

Generating a model with Hyper3D Rodin is a three-step asynchronous process. The LLM handles the polling automatically, but the steps are:

<Steps>
  <Step>
    **Create task** — Call `generate_hyper3d_model_via_text(text_prompt)` or `generate_hyper3d_model_via_images(image_urls)` to start generation. This returns a job ID.
  </Step>

  <Step>
    **Poll** — Call `poll_rodin_job_status(job_id)` repeatedly until the status returns `DONE`.
  </Step>

  <Step>
    **Import** — Call `import_generated_asset(name, job_id)` to download the generated GLB and place it in the scene.
  </Step>
</Steps>

<Warning>
  After import, always check the world bounding box and adjust location, scale, and rotation. AI-generated models may not align perfectly with your scene units or orientation.
</Warning>

## Best For

Use Hyper3D Rodin when you need custom or unique items that are not available in Poly Haven, Sketchfab, or Poly Pizza. It works best for single objects, not whole scenes.

<CardGroup cols={2}>
  <Card title="Custom Props" icon="sparkles">
    Unique objects that do not exist in any asset library, like a specific character or branded item.
  </Card>

  <Card title="Single Objects" icon="box">
    Individual models with clear boundaries. Avoid using Rodin for ground planes or environment elements.
  </Card>
</CardGroup>

## Limitations

Keep these constraints in mind when planning your prompts:

* Free trial keys have a daily generation limit.
* Rodin is designed for single-object generation. Do not try to generate a whole scene in one shot.
* Results may require cleanup, remeshing, or manual adjustment after import.

## Example Prompts

* "Generate a 3D model of a garden gnome through Hyper3D"
* "Create a futuristic weapon using Hyper3D"