import_generated_asset
Import 3D models generated by Hyper3D Rodin into Blender scenes using task UUID or request ID parameters for different generation modes.
Instructions
Import the asset generated by Hyper3D Rodin after the generation task is completed.
Parameters:
name: The name of the object in scene
task_uuid: For Hyper3D Rodin mode MAIN_SITE: The task_uuid given in the generate model step.
request_id: For Hyper3D Rodin mode FAL_AI: The request_id given in the generate model step.
Only give one of {task_uuid, request_id} based on the Hyper3D Rodin Mode! Return if the asset has been imported successfully.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | ||
| task_uuid | No | ||
| request_id | No |
Implementation Reference
- src/blender_mcp/server.py:846-877 (handler)The core handler function for the 'import_generated_asset' tool, decorated with @mcp.tool() for MCP registration. It handles input parameters, constructs kwargs, sends the import command to the Blender connection, and returns the result or error.
@mcp.tool() def import_generated_asset( ctx: Context, name: str, task_uuid: str=None, request_id: str=None, ): """ Import the asset generated by Hyper3D Rodin after the generation task is completed. Parameters: - name: The name of the object in scene - task_uuid: For Hyper3D Rodin mode MAIN_SITE: The task_uuid given in the generate model step. - request_id: For Hyper3D Rodin mode FAL_AI: The request_id given in the generate model step. Only give one of {task_uuid, request_id} based on the Hyper3D Rodin Mode! Return if the asset has been imported successfully. """ try: blender = get_blender_connection() kwargs = { "name": name } if task_uuid: kwargs["task_uuid"] = task_uuid elif request_id: kwargs["request_id"] = request_id result = blender.send_command("import_generated_asset", kwargs) return result except Exception as e: logger.error(f"Error generating Hyper3D task: {str(e)}") return f"Error generating Hyper3D task: {str(e)}" - src/blender_mcp/server.py:853-863 (schema)The docstring provides the input schema description, parameter details, and usage instructions for the tool.
""" Import the asset generated by Hyper3D Rodin after the generation task is completed. Parameters: - name: The name of the object in scene - task_uuid: For Hyper3D Rodin mode MAIN_SITE: The task_uuid given in the generate model step. - request_id: For Hyper3D Rodin mode FAL_AI: The request_id given in the generate model step. Only give one of {task_uuid, request_id} based on the Hyper3D Rodin Mode! Return if the asset has been imported successfully. """ - src/blender_mcp/server.py:920-922 (helper)Reference in the asset_creation_strategy prompt explaining usage of the tool post-generation.
- Use import_generated_asset() to import the generated GLB model the asset 4. After importing the asset, ALWAYS check the world_bounding_box of the imported mesh, and adjust the mesh's location and size Adjust the imported mesh's location, scale, rotation, so that the mesh is on the right spot. - src/blender_mcp/server.py:846-846 (registration)The @mcp.tool() decorator registers the function as an MCP tool.
@mcp.tool()