3d-reconstruction

Transform Images into 3D Shapes with Hunyuan3d 2 Test

26 Apr 2025
Transform Images into 3D Shapes with Hunyuan3d 2 Test

In the ever-evolving landscape of digital content creation, the ability to convert 2D images into 3D models has become an invaluable asset. The Hunyuan3d 2 Test provides a powerful Cognitive Action that enables developers to generate intricate 3D shapes from static images effortlessly. This service not only simplifies the process of 3D reconstruction but also enhances the creative possibilities for applications in gaming, virtual reality, and design. By leveraging customizable parameters, users can achieve highly detailed and tailored outputs, making it ideal for a range of use cases.

Prerequisites

To get started, you will need an API key for the Cognitive Actions service and a basic understanding of how to make API calls.

Generate 3D Shape from Image

The "Generate 3D Shape from Image" action transforms a given input image into a 3D shape. By utilizing a randomized seed, developers can achieve deterministic outputs while customizing various aspects of the generation process, such as the number of inference steps, guidance scale, and mesh details. This action is categorized under 3D reconstruction, making it a robust tool for developers looking to integrate 3D content generation into their applications.

Input Requirements: The input for this action requires a structured object that includes:

  • seed: An integer value for random seed generation (default: 1234).
  • image: A URI pointing to the input image (e.g., "https://example.com/image.png").
  • steps: An integer specifying the number of inference steps (20 to 50, default: 50).
  • guidanceScale: A floating-point number to control the model's adherence to prompts (1 to 20, default: 5.5).
  • numberOfChunks: An integer defining the number of chunks for mesh generation (10,000 to 200,000, default: 200,000).
  • maximumFaceCount: An integer for the maximum number of faces in the mesh (10,000 to 200,000, default: 40,000).
  • octreeResolution: An integer for the octree resolution (options: 256, 384, 512, default: 512).
  • removeBackground: A boolean flag indicating if the background should be removed (default: true).

Expected Output: The action returns a mesh in the form of a URI, which can be used in various applications to render the 3D shape. An example output would be:

{
  "mesh": "https://assets.cognitiveactions.com/invocations/487d5ad2-9435-4b6a-82ca-95ed7062b63a/fa59f052-594f-4010-903c-578650446675.glb"
}

Use Cases for this specific action:

  • Game Development: Quickly generate 3D models for characters or environments from concept art or sketches.
  • Virtual Reality: Create immersive experiences by converting 2D images into 3D objects that can be manipulated within a VR space.
  • E-commerce: Enhance product listings by offering interactive 3D views of items, improving customer engagement and decision-making.

```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 = "ed911425-2f46-4baf-965a-e452ca561404" # Action ID for: Generate 3D Shape from Image

# 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": 256,
  "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
The Hunyuan3d 2 Test offers a seamless solution for developers looking to incorporate 3D shape generation into their projects. With its customizable parameters and easy integration, this Cognitive Action opens up numerous possibilities across various fields, from gaming to e-commerce. By transforming static images into dynamic 3D models, you can enhance user experiences and bring your vision to life. Explore the potential of 3D reconstruction today and elevate your applications to new heights!
← Back to All Articles