3d-reconstruction

Create Stunning 3D Models with Text2vox Cognitive Actions

26 Apr 2025
Create Stunning 3D Models with Text2vox Cognitive Actions

Text2vox is a powerful service designed for developers who want to generate intricate 3D models with ease. Utilizing advanced algorithms, Text2vox allows you to create both high-detail and low-detail MagicaVoxel VOX models, making it an ideal solution for game developers, animators, and 3D artists. By simply providing a textual description, you can transform your ideas into vivid 3D representations, significantly speeding up the design process and reducing the complexity of model creation.

Imagine crafting detailed game characters, whimsical creatures, or unique environments without the need for extensive 3D modeling skills. Text2vox streamlines this process, enabling you to focus on creativity rather than technical hurdles. Whether you are developing assets for a game, creating artwork, or working on educational projects, Text2vox offers a versatile solution that caters to a wide range of applications.

Prerequisites

To get started with Text2vox, you will need a Cognitive Actions API key and a basic understanding of how to make API calls.

Generate MagicaVoxel Models

The "Generate MagicaVoxel Models" action allows you to create detailed 3D models from a textual prompt. This action leverages both the Flux and Hunyuan 3D-2 models to provide flexibility in resolution and detail. The primary purpose of this action is to simplify the modeling process, allowing you to generate complex voxel scenes with just a few parameters.

Input Requirements

To use this action, you must provide the following inputs:

  • prompt (required): A textual description of the scene or object you wish to create. For example, "A wizard in a purple robe and pointed hat, wielding a staff and casting a spell."
  • seed (optional): An integer that ensures consistency in generated models when using the same prompt. Default is 1234.
  • guidance (optional): A scaling factor (0-10) that influences how closely the output adheres to the prompt. Default is 6.
  • guidanceScale (optional): A factor (1-20) that affects the guidance influence in the model generation. Default is 5.5.
  • promptStrength (optional): Determines the strength of the prompt during image-to-image conversion. Default is 0.8.
  • resolutionOctree (optional): Sets the octree resolution, with values of 256, 384, or 512. Default is 512.
  • inferenceStepsFlux (optional): The number of processing iterations for Flux, ranging from 1 to 50. Default is 50.
  • isBackgroundRemoved (optional): Indicates if the background should be removed from the generated model. Default is true.
  • inferenceStepsHunyuan (optional): The number of inference steps for Hunyuan, ranging from 20 to 50. Default is 50.
  • resolutionDetailLevel (optional): Specifies the detail level of the voxel model as either 'high' or 'low'. Default is 'high'.

Expected Output

Upon successful execution, you will receive URLs pointing to the generated 3D models in various formats, such as .glb and .vox. These outputs can be directly used in your projects or modified further as needed.

Use Cases for this specific action

  • Game Development: Quickly create characters, props, and environments based on narrative descriptions, enhancing your game's visual elements without the need for extensive modeling.
  • Animation: Generate 3D models to be animated, allowing for rapid prototyping of scenes and characters.
  • Educational Projects: Use Text2vox to create visual aids for teaching concepts in 3D modeling or art, making learning more engaging.
  • Artistic Exploration: Artists can experiment with different prompts to create unique voxel art, pushing the boundaries of creativity.

```python
import requests
import json

# Replace with your actual Cognitive Actions API key and endpoint
# Ensure your environment securely handles the API key
COGNITIVE_ACTIONS_API_KEY = "YOUR_COGNITIVE_ACTIONS_API_KEY"
# This endpoint URL is hypothetical and should be documented for users
COGNITIVE_ACTIONS_EXECUTE_URL = "https://api.cognitiveactions.com/actions/execute"

action_id = "79ce8c8d-8b46-45c9-bca7-74c3fe79c46b" # Action ID for: Generate MagicaVoxel Models

# Construct the exact input payload based on the action's requirements
# This example uses the predefined example_input for this action:
payload = {
  "seed": 1234,
  "prompt": "A wizard in a purple robe and pointed hat, wielding a staff and casting a spell.",
  "guidance": 6,
  "guidanceScale": 5.5,
  "promptStrength": 0.8,
  "resolutionOctree": 512,
  "inferenceStepsFlux": 50,
  "isBackgroundRemoved": true,
  "inferenceStepsHunyuan": 50,
  "resolutionDetailLevel": "high"
}

headers = {
    "Authorization": f"Bearer {COGNITIVE_ACTIONS_API_KEY}",
    "Content-Type": "application/json",
    # Add any other required headers for the Cognitive Actions API
}

# Prepare the request body for the hypothetical execution endpoint
request_body = {
    "action_id": action_id,
    "inputs": payload
}

print(f"--- Calling Cognitive Action: {action.name or action_id} ---")
print(f"Endpoint: {COGNITIVE_ACTIONS_EXECUTE_URL}")
print(f"Action ID: {action_id}")
print("Payload being sent:")
print(json.dumps(request_body, indent=2))
print("------------------------------------------------")

try:
    response = requests.post(
        COGNITIVE_ACTIONS_EXECUTE_URL,
        headers=headers,
        json=request_body
    )
    response.raise_for_status() # Raise an exception for bad status codes (4xx or 5xx)

    result = response.json()
    print("Action executed successfully. Result:")
    print(json.dumps(result, indent=2))

except requests.exceptions.RequestException as e:
    print(f"Error executing action {action_id}: {e}")
    if e.response is not None:
        print(f"Response status: {e.response.status_code}")
        try:
            print(f"Response body: {e.response.json()}")
        except json.JSONDecodeError:
            print(f"Response body (non-JSON): {e.response.text}")
    print("------------------------------------------------")



## Conclusion

Text2vox revolutionizes the way developers approach 3D modeling by transforming simple text prompts into detailed voxel models. With its ease of use and flexibility, it opens up numerous possibilities for game design, animation, education, and artistic expression. By integrating Text2vox into your workflow, you can streamline your creative processes and bring your ideas to life faster than ever. 

Next steps might include experimenting with different prompts and parameters to see how they affect the output, or integrating the generated models into your projects for further testing and refinement. Embrace the power of Text2vox and elevate your 3D modeling capabilities today!
← Back to All Articles