Transform 2D to 3D: Integrating Morphix3D Cognitive Actions for Developers

21 Apr 2025
Transform 2D to 3D: Integrating Morphix3D Cognitive Actions for Developers

The Morphix 3D Cognitive Actions offer an innovative approach to converting 2D images and text descriptions into detailed 3D models. This AI-powered tool is ideal for developers looking to enhance applications in gaming, animation, and augmented/virtual reality (AR/VR). By leveraging these pre-built actions, developers can focus on building immersive experiences without needing extensive knowledge in 3D modeling.

Prerequisites

Before diving into the integration of Morphix 3D Cognitive Actions, ensure you have the following prerequisites:

  • API Key: You will need to obtain an API key to authenticate your requests to the Cognitive Actions platform.
  • Environment Setup: Make sure your development environment can make HTTP requests, and you have the required libraries installed (e.g., requests for Python).

Authentication typically involves passing your API key in the request headers to validate your access.

Cognitive Actions Overview

Transform Images and Text to 3D Models

The Transform Images and Text to 3D Models action utilizes Morphix 3D to convert 2D images and text descriptions into high-quality 3D models. This capability can significantly enhance visual experiences in various applications.

  • Category: 3D Reconstruction

Input

The input for this action requires several fields to effectively generate a 3D model:

  • prompt (string, optional): A clear and descriptive prompt used for generating a 3D model. Enhancing the prompt can improve the generation quality.
  • inputImageUrl (string, required): A URL pointing to an image used for generating a 3D model. Ensure the URL is accessible and points to a valid image format.
  • inferenceSteps (integer, optional): The number of inference steps to be performed. This affects the quality and speed of generation. Acceptable values range from 20 to 50.
  • videoBrightness (number, optional): Adjusts the brightness of the generated sample video. The default value is 1.5, suitable for brighter videos, with a range from 0.3 to 3.

Example Input:

{
  "inputImageUrl": "https://replicate.delivery/pbxt/MU7TaRF0oMhOR69ulv2J6vdTBkXveIc82qt8Z6VWJygoGkkg/test.webp",
  "inferenceSteps": 30,
  "videoBrightness": 1.5
}

Output

Upon executing this action, you can expect the following output:

  • video (string): A URL to the generated video of the 3D model.
  • initImg (string): A URL to the initial image used in the generation process.
  • thumbImg (string): A URL to a thumbnail image of the generated model.
  • outputGlb (string): A URL to the generated 3D model in GLB format.
  • generatedMesh (string): A URL to the generated mesh.
  • replicateStatus (string): Indicates the status of the operation, e.g., "success".

Example Output:

{
  "video": "https://assets.cognitiveactions.com/invocations/05273d28-4c06-4c4b-ad4b-e17a432f4078/453755ef-23ce-4793-a3b2-b11914b68ad6.mp4",
  "initImg": "https://assets.cognitiveactions.com/invocations/05273d28-4c06-4c4b-ad4b-e17a432f4078/5a5aaf77-d455-4418-9b5c-02c1f9e25512.png",
  "thumbImg": "https://assets.cognitiveactions.com/invocations/05273d28-4c06-4c4b-ad4b-e17a432f4078/d059144f-f514-4267-b11b-0a3ad2cbea54.png",
  "outputGlb": "https://assets.cognitiveactions.com/invocations/05273d28-4c06-4c4b-ad4b-e17a432f4078/16ea5e18-cfec-4cd9-9fa9-4dc6914721e2.glb",
  "generatedMesh": "https://assets.cognitiveactions.com/invocations/05273d28-4c06-4c4b-ad4b-e17a432f4078/b1042a42-114c-4a3f-9ab3-86991ac277e3.glb",
  "replicateStatus": "success"
}

Conceptual Usage Example (Python)

Here’s how you might call the Morphix 3D Cognitive Actions in Python:

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 = "48511fd9-6988-40cb-8c17-a5aef603605d"  # Action ID for Transform Images and Text to 3D Models

# Construct the input payload based on the action's requirements
payload = {
    "inputImageUrl": "https://replicate.delivery/pbxt/MU7TaRF0oMhOR69ulv2J6vdTBkXveIc82qt8Z6VWJygoGkkg/test.webp",
    "inferenceSteps": 30,
    "videoBrightness": 1.5
}

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 code snippet, replace "YOUR_COGNITIVE_ACTIONS_API_KEY" with your actual API key. The action ID and input payload are set according to the specifications provided. This example demonstrates how to structure your request and handle responses effectively.

Conclusion

The Morphix 3D Cognitive Actions provide a powerful tool for transforming 2D images and text into immersive 3D models. By utilizing these actions, developers can streamline their workflow and enhance their applications with high-quality 3D content. Consider exploring further use cases such as integrating these models into AR/VR experiences or creating interactive gaming environments. Start integrating today and bring your creative visions to life!

← Back to All Articles