3d-reconstruction

Create Stunning 3D Assets Effortlessly with Hunyuan3d 2

25 Apr 2025
Create Stunning 3D Assets Effortlessly with Hunyuan3d 2

In today's digital landscape, the demand for high-quality 3D assets is continually growing, driven by industries such as gaming, film, and virtual reality. Hunyuan3d 2 offers a powerful solution for developers looking to streamline the creation of textured 3D models. By leveraging advanced diffusion models, this service simplifies the generation of high-resolution 3D assets directly from input images. With customizable parameters, developers can achieve optimal results tailored to their specific needs, enhancing both productivity and creativity.

Whether you're working on a video game, an animated film, or an architectural visualization, Hunyuan3d 2 can help you create realistic 3D representations quickly and efficiently. Imagine transforming a simple 2D image into a detailed 3D model with just a few API calls—this is the future of asset creation!

Prerequisites

To get started, you will need a Cognitive Actions API key and a basic understanding of making API calls.

Generate 3D Assets with Diffusion Models

The primary action offered by Hunyuan3d 2 is the ability to generate 3D assets using diffusion models. This action allows developers to create high-resolution, textured 3D assets from 2D images, effectively solving the problem of time-consuming and often complex 3D modeling processes.

Input Requirements

The action requires a JSON object with the following parameters:

  • seed: An integer value to initialize the random number generator for reproducible results (default: 1234).
  • image: A URI pointing to the input image that will be transformed into a 3D shape.
  • steps: An integer specifying the number of inference steps to perform, ranging from 20 to 50 (default: 50).
  • guidanceScale: A number that controls the influence of guiding conditions, with a valid range from 1 to 20 (default: 5.5).
  • octreeResolution: An integer that determines the resolution of the octree used in mesh generation, with selectable values of 256, 384, or 512 (default: 256).
  • removeBackground: A boolean that indicates whether to remove the background from the input image (default: true).

Expected Output

The output will be a JSON object containing a URL to the generated 3D mesh in GLB format, which can be easily integrated into various applications.

Use Cases for this Action

  • Game Development: Quickly create realistic 3D models for characters, environments, or props based on concept art or reference images.
  • Virtual Reality: Generate immersive 3D assets that enhance user experiences in virtual environments.
  • Architectural Visualization: Transform architectural sketches or photos into detailed 3D representations for presentations or client reviews.

By using this action, developers can significantly reduce the time and effort involved in 3D asset creation, allowing more focus on design and innovation.

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 = "26046942-5746-4484-947d-382195eddceb" # Action ID for: Generate 3D Assets with Diffusion 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,
  "image": "https://replicate.delivery/pbxt/MVC2B2XKgv4X13qIpW6t2m59EVfY2CqaS9e2CSsWNHPJjQAd/image.png",
  "steps": 50,
  "guidanceScale": 5.5,
  "octreeResolution": 512,
  "removeBackground": true
}

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

Hunyuan3d 2 revolutionizes the way developers create 3D assets by providing a fast and efficient solution for generating high-quality models from 2D images. The flexibility offered by customizable parameters ensures that developers can achieve the desired results for any project. Whether you're in game design, virtual reality, or architectural visualization, integrating Hunyuan3d 2 into your workflow can enhance your productivity and creative output.

Ready to elevate your 3D asset creation? Start leveraging Hunyuan3d 2 today!

← Back to All Articles