image-generation

Accelerate Garment Model Generation with Oot Diffusion and Masks

26 Apr 2025
Accelerate Garment Model Generation with Oot Diffusion and Masks

The "Oot Diffusion With Mask" service provides a powerful API designed to streamline the process of generating garment models using image masks. By leveraging advanced diffusion techniques, developers can enhance the speed and accuracy of model generation, making it an invaluable tool for fashion tech, e-commerce, and virtual fitting applications.

Imagine needing to generate realistic garment overlays on model images quickly; this service allows you to do just that by using specific masks that delineate the areas of interest, ensuring that your garment models look natural and fit seamlessly. Whether you're building a virtual fashion show, developing a fitting room application, or creating a catalog of clothing items, this API can help you achieve stunning results efficiently.

Prerequisites

To get started with the Oot Diffusion With Mask API, you'll need an API key, and a basic understanding of making API calls is essential.

Generate Garment Model with Mask

Purpose

The "Generate Garment Model with Mask" action accelerates the generation of garment models by utilizing a mask image. This enhances processing speed and precision, allowing for more realistic and contextually accurate images compared to traditional methods.

Input Requirements

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

  • Seed: A non-negative integer that initializes the random number generator, ensuring reproducibility (default is 0).
  • Steps: The number of inference steps to perform, ranging from 1 to 40 (default is 20).
  • Model Image: A URI pointing to a clear image of the model, which serves as the base for processing.
  • Person Mask: A URI for the image mask of a person's upper body, which helps in defining the areas for image processing.
  • Garment Image: A URI pointing to a clear image of the upper body garment that will be overlaid or analyzed with the model image.
  • Guidance Scale: A numeric scale from 1 to 5 that adjusts the strength of guidance during inference (default is 2).

Example input might look like this:

{
  "seed": 99999,
  "steps": 20,
  "modelImage": "https://raw.githubusercontent.com/viktorfa/oot_diffusion/main/oot_diffusion/assets/model_1.png",
  "personMask": "https://raw.githubusercontent.com/viktorfa/oot_diffusion/main/oot_diffusion/assets/model_1_mask.png",
  "garmentImage": "https://raw.githubusercontent.com/viktorfa/oot_diffusion/main/oot_diffusion/assets/cloth_1.jpg",
  "guidanceScale": 2
}

Expected Output

The output will be a collection of generated images showcasing the garment model overlaid on the specified model image. This allows developers to easily visualize how the garment fits on the model.

Example output could include URLs to generated images, such as:

  • https://assets.cognitiveactions.com/invocations/d2d0529a-b9fb-4222-a85d-9d3bac8069f5/cff5e16a-ae45-4052-8c65-efce65be3d77.png
  • https://assets.cognitiveactions.com/invocations/d2d0529a-b9fb-4222-a85d-9d3bac8069f5/d3684a5c-95dc-4081-91b8-1eb76524e420.png

Use Cases for this Action

This action is particularly useful in several scenarios:

  • E-commerce Platforms: Integrate this API to provide customers with a virtual try-on experience, helping them visualize how garments will look on a model.
  • Fashion Design: Designers can quickly prototype how their designs will look on different body types, speeding up the design iteration process.
  • Marketing: Create visually appealing marketing materials that showcase clothing items on models, enhancing the overall presentation of products.

```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 = "74a09852-65e2-48a8-a97a-7e02786b5312" # Action ID for: Generate Garment Model with Mask

# Construct the exact input payload based on the action's requirements
# This example uses the predefined example_input for this action:
payload = {
  "seed": 99999,
  "steps": 20,
  "modelImage": "https://raw.githubusercontent.com/viktorfa/oot_diffusion/main/oot_diffusion/assets/model_1.png",
  "personMask": "https://raw.githubusercontent.com/viktorfa/oot_diffusion/main/oot_diffusion/assets/model_1_mask.png",
  "garmentImage": "https://raw.githubusercontent.com/viktorfa/oot_diffusion/main/oot_diffusion/assets/cloth_1.jpg",
  "guidanceScale": 2
}

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

The "Oot Diffusion With Mask" service offers developers a robust solution for garment model generation, combining speed and precision to meet the demands of modern fashion technology. With the ability to create realistic garment overlays and a range of practical use cases, this API can significantly enhance your applications. 

Next steps could include integrating this service into your existing projects, experimenting with different input configurations, or exploring additional features offered by the API to maximize its potential in your specific use cases.
← Back to All Articles