Seamlessly Integrate Virtual Dressing Predictions with Cognitive Actions

25 Apr 2025
Seamlessly Integrate Virtual Dressing Predictions with Cognitive Actions

In the realm of fashion technology, the omniedgeio/virtual-dressing API provides developers with the ability to simulate dressing experiences using advanced image processing techniques. By leveraging Cognitive Actions, you can execute virtual dressing predictions, enabling users to see how garments would look on a model based on provided images. This functionality enhances online shopping experiences, making them more interactive and visually engaging.

Prerequisites

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

  • An API key for accessing the Cognitive Actions platform.
  • Basic knowledge of making HTTP requests and handling JSON data.

Authentication typically involves passing your API key in the headers of your requests, allowing you to securely access the functionality of Cognitive Actions.

Cognitive Actions Overview

Execute Virtual Dressing Prediction

The Execute Virtual Dressing Prediction action allows you to simulate how a garment looks on a model by providing images of both. This action is particularly useful for e-commerce platforms, fashion apps, and any service looking to enhance user engagement through visual technology.

  • Category: Image Processing

Input

The action requires the following fields in its input schema:

{
  "seed": 0,
  "steps": 30,
  "modelPicture": "https://replicate.delivery/pbxt/KXZRucHM1bbj49bWhUsZRw9GD4DYpgbHuuWyknmIybMMrHWG/ltfp4dlj.jpeg",
  "guidanceScale": 3,
  "garmentPicture": "https://replicate.delivery/pbxt/KXZRuw8l44Q7wIML5dhP5o47l2BEpENFQ1VpDejfUlk3nWCh/IMG_1210.jpg",
  "clothingCategory": "upperbody"
}
  • Fields:
    • seed: (integer, optional) A seed for reproducibility of results (defaults to 0).
    • steps: (integer, optional) Number of inference steps, must be between 1 and 40 (default is 20).
    • modelPicture: (string, required) URI of the model's image.
    • guidanceScale: (number, optional) A scale from 1 to 5 influencing model output (default is 2).
    • garmentPicture: (string, required) URI of the garment's image.
    • clothingCategory: (string, optional) Category of the garment, can be upperbody, lowerbody, or dress (default is upperbody).

Output

The action typically returns a list of image URIs showcasing the virtual dressing results:

[
  "https://assets.cognitiveactions.com/invocations/c22eb8fc-20f6-4a32-833f-4faef8cd457e/18e83d9e-2e3f-40bc-97cd-1cb70a32b919.png",
  "https://assets.cognitiveactions.com/invocations/c22eb8fc-20f6-4a32-833f-4faef8cd457e/5bda76de-64b5-4194-93ac-b4cc504878e5.png",
  "https://assets.cognitiveactions.com/invocations/c22eb8fc-20f6-4a32-833f-4faef8cd457e/4a38e8b2-0718-43ee-a2d7-fa20af37e31b.png",
  "https://assets.cognitiveactions.com/invocations/c22eb8fc-20f6-4a32-833f-4faef8cd457e/e3120556-bedf-4a8d-8621-8bb7c97a2bd0.png"
]

The output will consist of multiple images showing the model dressed in the provided garment.

Conceptual Usage Example (Python)

Here’s how you might call the Execute Virtual Dressing Prediction 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 = "0a41a5f6-0c69-48b3-9a17-a0f82cc1d7cf"  # Action ID for Execute Virtual Dressing Prediction

# Construct the input payload based on the action's requirements
payload = {
    "seed": 0,
    "steps": 30,
    "modelPicture": "https://replicate.delivery/pbxt/KXZRucHM1bbj49bWhUsZRw9GD4DYpgbHuuWyknmIybMMrHWG/ltfp4dlj.jpeg",
    "guidanceScale": 3,
    "garmentPicture": "https://replicate.delivery/pbxt/KXZRuw8l44Q7wIML5dhP5o47l2BEpENFQ1VpDejfUlk3nWCh/IMG_1210.jpg"
}

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 is set to the ID for the Execute Virtual Dressing Prediction action.
  • The payload is constructed according to the required input schema.

Conclusion

The Execute Virtual Dressing Prediction action offers a powerful way to enhance user experience in fashion applications by providing realistic garment visualizations. With simple integration through Cognitive Actions, developers can create interactive experiences that drive user engagement and satisfaction. Explore additional use cases and customize the parameters to fit your application's needs for optimal results!

← Back to All Articles