image-segmentation

Effortless Outfit Segmentation with Ootd Masking

25 Apr 2025
Effortless Outfit Segmentation with Ootd Masking

In the world of fashion and e-commerce, understanding how to effectively showcase clothing items is essential. The "Ootd Masking" service offers developers a powerful tool for generating outfit segmentation masks, simplifying the process of separating clothing into distinct pieces. This service not only enhances visual presentations but also streamlines workflows for fashion-related applications. By automatically generating segmentation masks, Ootd Masking provides a way to improve user engagement, simplify inventory management, and facilitate better styling recommendations.

Imagine a scenario where an online clothing store wants to display their outfits in a more interactive way. With Ootd Masking, developers can easily integrate outfit segmentation into their applications, allowing users to see not just the whole outfit, but also the individual top and bottom pieces. This can lead to higher customer satisfaction and increased sales conversions as customers can visualize how different items pair together.

Prerequisites

To get started with Ootd Masking, you'll need an API key for the Cognitive Actions service and a basic understanding of making API calls.

Generate Outfit Segmentation Masks

The primary action of Ootd Masking is to generate outfit segmentation masks from images of outfits. This action effectively separates clothing into top and bottom pieces, while also removing the background and refining the edges of the garments.

Input Requirements

To use this action, you'll need to provide:

  • Image URL: A valid URI that points to the image resource containing the outfit.
  • OOTD Type: Specify whether the outfit piece is a "top" or "bottom" (defaults to "top").
  • Output Format: Currently, only "png" format is supported (defaults to "png").

Example Input:

{
  "image": "https://replicate.delivery/pbxt/M9pWj21SGmFuUXwIk9EwQ6t1KX22xuF97xugTa88sIRodNLo/yuki.png",
  "ootdType": "bottom",
  "outputFormat": "png"
}

Expected Output

The output will be a PNG image that features the segmented outfit piece, ready for use in various applications.

Example Output:

https://assets.cognitiveactions.com/invocations/d303d527-7a61-4e78-9361-9e00ed45da2d/0ec4dc2b-018a-40ad-b64c-8528294bd15c.png

Use Cases for this Action

  • E-commerce Platforms: Enhance product listings with segmented images that allow customers to view individual clothing pieces.
  • Fashion Apps: Provide users with styling suggestions by showcasing how different tops and bottoms can be combined.
  • Social Media: Enable fashion influencers to create engaging content by isolating outfit pieces for visual storytelling.

```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 = "e2b254c2-e54f-4d79-bb2f-34cc4a4c9ea0" # Action ID for: Generate Outfit Segmentation Masks

# Construct the exact input payload based on the action's requirements
# This example uses the predefined example_input for this action:
payload = {
  "image": "https://replicate.delivery/pbxt/M9pWj21SGmFuUXwIk9EwQ6t1KX22xuF97xugTa88sIRodNLo/yuki.png",
  "ootdType": "bottom",
  "outputFormat": "png"
}

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
Ootd Masking revolutionizes the way developers can display clothing items by providing a straightforward method for generating outfit segmentation masks. This capability not only enhances visual appeal but also opens up new possibilities for user engagement in fashion-related applications. By utilizing this service, developers can create richer, more interactive experiences that cater to the needs of modern consumers. Start integrating Ootd Masking today, and elevate your application to the next level in the fashion industry.
← Back to All Articles