Transform Your Fashion E-commerce Experience with the viktorfa/oot_diffusion Cognitive Actions

23 Apr 2025
Transform Your Fashion E-commerce Experience with the viktorfa/oot_diffusion Cognitive Actions

The viktorfa/oot_diffusion API provides powerful Cognitive Actions that enable developers to create engaging visual experiences, particularly in the fashion industry. One standout feature is the ability to generate a virtual dressing room experience by overlaying garment images onto model images. This not only enhances user interaction but also helps in visualizing how clothing items would look when worn, greatly benefiting e-commerce platforms.

Prerequisites

Before diving into the integration of the Cognitive Actions, ensure you have:

  • An API key for the Cognitive Actions platform.
  • Basic familiarity with making API calls and handling JSON data structures.

Authentication typically involves including your API key in the request headers to authorize your calls to the Cognitive Actions endpoint.

Cognitive Actions Overview

Create Virtual Dressing Room Visualization

The Create Virtual Dressing Room Visualization action allows you to generate compelling images that overlay garment visuals onto model images, providing a realistic representation of clothing on a model.

  • Category: Image Processing

Input

To invoke this action, you need to structure your input according to the specification below:

  • seed: (integer, optional) A numerical seed for random number generation, impacting the reproducibility of the output. Range: 0 to 18446744073709552000. Default: 0.
  • steps: (integer, optional) The number of inference steps used in the process, influencing detail level. Range: 1 to 40. Default: 20.
  • modelImage: (string, required) A URI pointing to a clear image of the model. This serves as the base for the overlay.
  • garmentImage: (string, required) A URI pointing to a clear image of the garment to overlay on the model.
  • guidanceScale: (number, optional) A scale factor for guiding output consistency with the input image. Range: 1 to 5. Default: 2.

Example Input:

{
  "seed": 0,
  "steps": 20,
  "modelImage": "https://raw.githubusercontent.com/viktorfa/oot_diffusion/main/oot_diffusion/assets/model_1.png",
  "garmentImage": "https://replicate.delivery/pbxt/KTgyzr0WNtcgwN82xEEcc3zoydD8ooXPzMHC18fKZSWu9W5I/blue_jacket.webp",
  "guidanceScale": 2
}

Output

Upon successful execution, the action returns an array of image URLs representing the overlayed garment on the model. The output may vary with different input parameters.

Example Output:

[
  "https://assets.cognitiveactions.com/invocations/2ceb1e4c-6218-485c-b356-755b108653b7/16683a9d-7cf1-4d43-b056-c8d9233f8f90.png",
  "https://assets.cognitiveactions.com/invocations/2ceb1e4c-6218-485c-b356-755b108653b7/3e3ad895-a34f-4c1b-94c5-3f71a6d27edf.png",
  "https://assets.cognitiveactions.com/invocations/2ceb1e4c-6218-485c-b356-755b108653b7/3d338fd3-e55e-4663-9c88-f6e89ea81697.png",
  "https://assets.cognitiveactions.com/invocations/2ceb1e4c-6218-485c-b356-755b108653b7/e6ffa077-8f00-47c0-a249-275869ba7d2f.png"
]

Conceptual Usage Example (Python)

Here's a conceptual example demonstrating how to call this Cognitive Action using 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 = "decdc7ec-ae5e-42ba-bb5c-68740fbde064" # Action ID for Create Virtual Dressing Room Visualization

# Construct the input payload based on the action's requirements
payload = {
    "seed": 0,
    "steps": 20,
    "modelImage": "https://raw.githubusercontent.com/viktorfa/oot_diffusion/main/oot_diffusion/assets/model_1.png",
    "garmentImage": "https://replicate.delivery/pbxt/KTgyzr0WNtcgwN82xEEcc3zoydD8ooXPzMHC18fKZSWu9W5I/blue_jacket.webp",
    "guidanceScale": 2
}

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 structured to align with the requirements of the Create Virtual Dressing Room Visualization action. The endpoint URL and request structure shown are illustrative and should be adapted based on your actual Cognitive Actions endpoint.

Conclusion

Integrating the viktorfa/oot_diffusion Cognitive Actions into your applications can significantly enhance user experiences, especially in the realm of fashion e-commerce. By leveraging the power of virtual dressing room visualizations, you can provide customers with a more immersive shopping experience. Explore these Cognitive Actions and consider how they might fit into your projects to drive engagement and increase conversions.

← Back to All Articles