Create Stunning Fashion Images with Maison Cognitive Actions

25 Apr 2025
Create Stunning Fashion Images with Maison Cognitive Actions

In the world of fashion and creative visualization, the ability to generate high-quality images based on customizable prompts can be a game-changer. The maison913/maison-cog-sdxl API offers a powerful Cognitive Action that allows developers to create stunning fashion model images using user-defined text prompts. With features to refine styles, adjust guidance levels, and manipulate image dimensions, this API opens up a realm of creative possibilities for fashion designers, marketers, and tech enthusiasts alike.

Prerequisites

Before diving into the implementation, you’ll need an API key for the Cognitive Actions platform. This key is crucial for authenticating your requests. Generally, authentication works by passing the API key in the headers of your HTTP requests. Ensure you have the necessary setup in place to start using the actions effectively.

Cognitive Actions Overview

Generate Fashion Model Image

The Generate Fashion Model Image action allows users to generate high-quality fashion images based on descriptive text prompts. It supports customization options for image dimensions, style refinement, and more, making it suitable for various creative applications.

Input

The input for this action is structured in a JSON format with the following fields:

  • seed (integer): Specifies the random seed for reproducibility. Leave blank for a random seed.
  • image (string): URI of the input image for img2img or inpaint modes.
  • width (integer): Width of the output image (default: 1024).
  • height (integer): Height of the output image (default: 1024).
  • prompt (string): Descriptive text for the desired output.
  • refineStyle (string): Selects the refinement style (options: no_refiner, base_image_refiner, expert_ensemble_refiner; default: expert_ensemble_refiner).
  • guidanceLevel (number): Strength of classifier-free guidance (range: 1-50; default: 7.5).
  • numberOfOutputs (integer): Number of images to output (range: 1-4; default: 1).
  • promptIntensity (number): Strength of the prompt in img2img/inpaint modes (range: 0-1; default: 0.8).
  • refinementSteps (integer): Number of refinement steps for base_image_refiner (default: 15).
  • highNoiseFraction (number): Fraction of noise for expert_ensemble_refiner (range: 0-1; default: 0.8).
  • negativeInputPrompt (string): Elements to avoid in the output.
  • schedulingAlgorithm (string): Algorithm for scheduling denoising steps (options include DDIM, DPMSolverMultistep, etc.; default: DPMSolverMultistep).
  • numberOfInferenceSteps (integer): Number of denoising steps (range: 1-100; default: 50).

Example Input:

{
  "seed": 45474,
  "width": 1024,
  "height": 1024,
  "prompt": "a aifw asian blue hair male model, wearing a oversized jacket with a kilt, prince of Wales print, in water catwalk, crowd sitting on both side of the catwalk, fashion runway",
  "refineStyle": "base_image_refiner",
  "guidanceLevel": 7.5,
  "refinementSteps": 15,
  "highNoiseFraction": 0.8,
  "negativeInputPrompt": "",
  "schedulingAlgorithm": "DDIM",
  "numberOfInferenceSteps": 40
}

Output

The output typically returns a URL link to the generated image.

Example Output:

[
  "https://assets.cognitiveactions.com/invocations/cac3b854-98f1-42b8-84f0-a3bf9ee73061/bba5a8f8-6a94-4b5f-9630-1a032c69b1ec.png"
]

Conceptual Usage Example (Python)

Here's a conceptual example of how you might call this 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 = "c4626c87-0471-4ddf-9b09-095b63c96105"  # Action ID for Generate Fashion Model Image

# Construct the input payload based on the action's requirements
payload = {
    "seed": 45474,
    "width": 1024,
    "height": 1024,
    "prompt": "a aifw asian blue hair male model, wearing a oversized jacket with a kilt, prince of Wales print, in water catwalk, crowd sitting on both side of the catwalk, fashion runway",
    "refineStyle": "base_image_refiner",
    "guidanceLevel": 7.5,
    "refinementSteps": 15,
    "highNoiseFraction": 0.8,
    "negativeInputPrompt": "",
    "schedulingAlgorithm": "DDIM",
    "numberOfInferenceSteps": 40
}

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 Python snippet:

  • Replace "YOUR_COGNITIVE_ACTIONS_API_KEY" with your actual API key.
  • The payload is constructed based on the required input schema.
  • The request is made to the hypothetical endpoint, and the response is printed.

Conclusion

The maison913/maison-cog-sdxl Cognitive Action for generating fashion model images is a powerful tool for developers looking to enhance their applications with creative image generation capabilities. By leveraging customizable parameters, you can produce stunning visuals that meet specific requirements. Whether you're building an application for fashion design, marketing, or artistic exploration, integrating this action can elevate your project's potential. Explore the possibilities and start creating today!

← Back to All Articles