Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| BLENDER_HOST | No | Host address for Blender socket server | localhost |
| BLENDER_PORT | No | Port number for Blender socket server | 9876 |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_scene_info | Get detailed information about the current Blender scene |
| get_object_info | Get detailed information about a specific object in the Blender scene. Parameters:
|
| get_viewport_screenshot | Capture a screenshot of the current Blender 3D viewport. Parameters:
Returns the screenshot as an Image. |
| execute_blender_code | Execute arbitrary Python code in Blender. Make sure to do it step-by-step by breaking it into smaller chunks. Parameters:
|
| get_polyhaven_categories | Get a list of categories for a specific asset type on Polyhaven. Parameters:
|
| search_polyhaven_assets | Search for assets on Polyhaven with optional filtering. Parameters:
Returns a list of matching assets with basic information. |
| download_polyhaven_asset | Download and import a Polyhaven asset into Blender. Parameters:
Returns a message indicating success or failure. |
| set_texture | Apply a previously downloaded Polyhaven texture to an object. Parameters:
Returns a message indicating success or failure. |
| get_polyhaven_status | Check if PolyHaven integration is enabled in Blender. Returns a message indicating whether PolyHaven features are available. |
| get_hyper3d_status | Check if Hyper3D Rodin integration is enabled in Blender. Returns a message indicating whether Hyper3D Rodin features are available. Don't emphasize the key type in the returned message, but sliently remember it. |
| get_sketchfab_status | Check if Sketchfab integration is enabled in Blender. Returns a message indicating whether Sketchfab features are available. |
| search_sketchfab_models | Search for models on Sketchfab with optional filtering. Parameters:
Returns a formatted list of matching models. |
| download_sketchfab_model | Download and import a Sketchfab model by its UID. Parameters:
Returns a message indicating success or failure. The model must be downloadable and you must have proper access rights. |
| generate_hyper3d_model_via_text | Generate 3D asset using Hyper3D by giving description of the desired asset, and import the asset into Blender. The 3D asset has built-in materials. The generated model has a normalized size, so re-scaling after generation can be useful. Parameters:
Returns a message indicating success or failure. |
| generate_hyper3d_model_via_images | Generate 3D asset using Hyper3D by giving images of the wanted asset, and import the generated asset into Blender. The 3D asset has built-in materials. The generated model has a normalized size, so re-scaling after generation can be useful. Parameters:
Only one of {input_image_paths, input_image_urls} should be given at a time, depending on the Hyper3D Rodin's current mode. Returns a message indicating success or failure. |
| poll_rodin_job_status | Check if the Hyper3D Rodin generation task is completed. For Hyper3D Rodin mode MAIN_SITE: Parameters: - subscription_key: The subscription_key given in the generate model step. Returns a list of status. The task is done if all status are "Done".
If "Failed" showed up, the generating process failed.
This is a polling API, so only proceed if the status are finally determined ("Done" or "Canceled"). For Hyper3D Rodin mode FAL_AI: Parameters: - request_id: The request_id given in the generate model step. Returns the generation task status. The task is done if status is "COMPLETED".
The task is in progress if status is "IN_PROGRESS".
If status other than "COMPLETED", "IN_PROGRESS", "IN_QUEUE" showed up, the generating process might be failed.
This is a polling API, so only proceed if the status are finally determined ("COMPLETED" or some failed state). |
| import_generated_asset | Import the asset generated by Hyper3D Rodin after the generation task is completed. Parameters:
Only give one of {task_uuid, request_id} based on the Hyper3D Rodin Mode! Return if the asset has been imported successfully. |
| get_hunyuan3d_status | Check if Hunyuan3D integration is enabled in Blender. Returns a message indicating whether Hunyuan3D features are available. Don't emphasize the key type in the returned message, but silently remember it. |
| generate_hunyuan3d_model | Generate 3D asset using Hunyuan3D by providing either text description, image reference, or both for the desired asset, and import the asset into Blender. The 3D asset has built-in materials. Parameters:
Returns:
|
| poll_hunyuan_job_status | Check if the Hunyuan3D generation task is completed. For Hunyuan3D: Parameters: - job_id: The job_id given in the generate model step. Returns the generation task status. The task is done if status is "DONE".
The task is in progress if status is "RUN".
If status is "DONE", returns ResultFile3Ds, which is the generated ZIP model path
When the status is "DONE", the response includes a field named ResultFile3Ds that contains the generated ZIP file path of the 3D model in OBJ format.
This is a polling API, so only proceed if the status are finally determined ("DONE" or some failed state). |
| import_generated_asset_hunyuan | Import the asset generated by Hunyuan3D after the generation task is completed. Parameters:
Return if the asset has been imported successfully. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| asset_creation_strategy | Defines the preferred strategy for creating assets in Blender |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |