Generate Stunning 3D Models with the deepeshsharma2003/3dmg Cognitive Actions

22 Apr 2025
Generate Stunning 3D Models with the deepeshsharma2003/3dmg Cognitive Actions

In the world of digital content creation, the ability to generate 3D models from images can significantly enhance projects ranging from gaming to virtual reality. The deepeshsharma2003/3dmg Cognitive Actions provide developers with an efficient way to generate high-quality 3D models directly from images. This article will guide you through the capabilities of the Cognitive Actions available in this spec, allowing you to integrate them into your applications seamlessly.

Prerequisites

Before you start using the Cognitive Actions, ensure you have the following:

  • An API key for the Cognitive Actions platform.
  • Basic knowledge of making HTTP requests and handling JSON data.
  • Familiarity with Python programming for implementing the code examples.

Authentication typically involves passing the API key in the request headers, allowing you to securely access the Cognitive Actions.

Cognitive Actions Overview

Generate 3D Model

The Generate 3D Model action takes an image as input and converts it into a 3D model. This action also allows for options such as exporting a video, creating texture maps, and removing the background from the original image. The action provides flexibility in terms of quality and consistency through adjustable parameters like random seed and sampling steps.

  • Category: 3D Reconstruction

Input

The input for this action requires the following fields:

  • imagePath (required): The URI of the input image to be processed.
  • seed (optional): An integer to initialize the random number generator (default is 42).
  • exportVideo (optional): A boolean flag indicating whether to export a video (default is true).
  • samplingSteps (optional): The number of steps used in the sampling process (default is 75).
  • exportTextureMap (optional): A boolean flag indicating whether to export a texture map (default is false).
  • removeBackground (optional): A boolean flag indicating whether to remove the background from the image (default is true).

Example Input:

{
  "imagePath": "https://media.istockphoto.com/id/469078110/photo/pikachu-figurine.jpg?s=612x612&w=0&k=20&c=hnnwI2IE_kCB2L2YYSEcRTWAcs7tDeAFkXv10RRbw8A="
}

Output

The action typically returns a list of URLs pointing to the generated assets, including:

  • A PNG image of the 3D model.
  • A video file showcasing the model.
  • A GLB file for the 3D model.

Example Output:

[
  "https://assets.cognitiveactions.com/invocations/42494a50-d4df-4f86-b49b-fae06a6b04cd/25aa45ec-d70a-4105-9312-0db4da6520d4.png",
  "https://assets.cognitiveactions.com/invocations/42494a50-d4df-4f86-b49b-fae06a6b04cd/fc442f23-ff49-4f12-a57a-8f692cc63949.mp4",
  "https://assets.cognitiveactions.com/invocations/42494a50-d4df-4f86-b49b-fae06a6b04cd/0f2103ae-da4a-4f4d-90ed-063b1f9e438d.glb"
]

Conceptual Usage Example (Python)

Here's a conceptual Python code snippet that demonstrates how to call the Generate 3D Model action:

import requests
import json

# Replace with your Cognitive Actions API key and endpoint
COGNITIVE_ACTIONS_API_KEY = "YOUR_COGNITIVE_ACTIONS_API_KEY"
COGNITIVE_ACTIONS_EXECUTE_URL = "https://api.cognitiveactions.com/actions/execute"  # Hypothetical endpoint

action_id = "66b77e90-3c79-491a-b40c-59446e50895d"  # Action ID for Generate 3D Model

# Construct the input payload based on the action's requirements
payload = {
    "imagePath": "https://media.istockphoto.com/id/469078110/photo/pikachu-figurine.jpg?s=612x612&w=0&k=20&c=hnnwI2IE_kCB2L2YYSEcRTWAcs7tDeAFkXv10RRbw8A="
}

headers = {
    "Authorization": f"Bearer {COGNITIVE_ACTIONS_API_KEY}",
    "Content-Type": "application/json"
}

try:
    response = requests.post(
        COGNITIVE_ACTIONS_EXECUTE_URL,
        headers=headers,
        json={"action_id": action_id, "inputs": payload}  # Hypothetical structure
    )
    response.raise_for_status()  # Raise an exception for bad status codes (4xx or 5xx)

    result = response.json()
    print("Action executed successfully:")
    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: {e.response.text}")

In this example, replace the placeholder API key and endpoint with your own. The payload variable contains the required input for the action, and the API call is made using a POST request. The response is then printed in a formatted JSON structure.

Conclusion

The deepeshsharma2003/3dmg Cognitive Actions present a powerful tool for developers aiming to create 3D models from images. By leveraging the capabilities of the Generate 3D Model action, you can automate complex modeling tasks and enhance your applications with visually rich content. Explore further by integrating these actions into your workflows or experimenting with different parameters to achieve the desired output. Happy coding!

← Back to All Articles