Enhance Your Applications with Image Generation Using d3vilsn0w/sdxl-fm Cognitive Actions

23 Apr 2025
Enhance Your Applications with Image Generation Using d3vilsn0w/sdxl-fm Cognitive Actions

In the world of AI-driven creativity, the d3vilsn0w/sdxl-fm API offers powerful Cognitive Actions for image generation. These pre-built actions allow developers to generate stunning images with remarkable flexibility, utilizing the advanced capabilities of the SDXL model. Whether you want to create art, enhance existing images, or customize visuals, these actions simplify the process, enabling rapid development and integration into your applications.

Prerequisites

Before diving into the implementation, you will need the following:

  • An API key for accessing the Cognitive Actions platform.
  • Familiarity with making HTTP requests in your programming language of choice.

Authentication is typically handled by including the API key in the headers of your requests, allowing you to securely access the features provided by the Cognitive Actions API.

Cognitive Actions Overview

Generate Images With Inpainting

The Generate Images With Inpainting action is designed to create high-quality images using either the img2img method or inpaint mode. This action allows for significant customization and refinement options, making it ideal for a variety of creative applications.

Input

The action accepts a structured input defined by the following schema:

{
  "mask": "string (uri)",
  "seed": "integer",
  "image": "string (uri)",
  "width": "integer (default: 1024)",
  "height": "integer (default: 1024)",
  "prompt": "string (default: 'An astronaut riding a rainbow unicorn')",
  "outputCount": "integer (default: 1, min: 1, max: 4)",
  "refineStyle": "string (default: 'no_refiner')",
  "customWeights": "string",
  "guidanceScale": "number (default: 7.5, min: 1, max: 50)",
  "loraIntensity": "number (default: 0.6, min: 0, max: 1)",
  "applyWatermark": "boolean (default: true)",
  "denoisingSteps": "integer (default: 50, min: 1, max: 500)",
  "negativePrompt": "string (default: '')",
  "promptStrength": "number (default: 0.8, min: 0, max: 1)",
  "refinementSteps": "integer",
  "schedulingMethod": "string (default: 'K_EULER')",
  "highNoiseFraction": "number (default: 0.8, min: 0, max: 1)",
  "safetyCheckerDisabled": "boolean (default: false)"
}

Example Input:

{
  "width": 1024,
  "height": 1024,
  "prompt": "A blonde girl riding a decorative gradient horse on the beach",
  "outputCount": 1,
  "refineStyle": "expert_ensemble_refiner",
  "guidanceScale": 7.5,
  "loraIntensity": 0.6,
  "applyWatermark": true,
  "denoisingSteps": 50,
  "promptStrength": 0.8,
  "schedulingMethod": "DDIM",
  "highNoiseFraction": 0.8
}

Output

The action returns a structured output with the generated image's URI. Here’s an example of the output you can expect:

[
  "https://assets.cognitiveactions.com/invocations/d9a6eaa0-1090-49d6-9ec3-a67b1dbdf1c0/d997037e-634e-47a3-92c4-5970c65dc3fb.png"
]

Conceptual Usage Example (Python)

Here's how you might invoke the Generate Images With Inpainting 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 = "335a2a9f-9b93-404c-9ac2-df96c7977c53"  # Action ID for Generate Images With Inpainting

# Construct the input payload based on the action's requirements
payload = {
    "width": 1024,
    "height": 1024,
    "prompt": "A blonde girl riding a decorative gradient horse on the beach",
    "outputCount": 1,
    "refineStyle": "expert_ensemble_refiner",
    "guidanceScale": 7.5,
    "loraIntensity": 0.6,
    "applyWatermark": True,
    "denoisingSteps": 50,
    "promptStrength": 0.8,
    "schedulingMethod": "DDIM",
    "highNoiseFraction": 0.8
}

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 example, replace YOUR_COGNITIVE_ACTIONS_API_KEY with your actual API key. The action ID and structured input payload are set according to the requirements of the Generate Images With Inpainting action.

Conclusion

The d3vilsn0w/sdxl-fm Cognitive Actions provide developers with robust tools for image generation and manipulation. By integrating these actions, you can create engaging visuals tailored to your application's needs. Explore use cases such as automated art generation, custom image editing, or even enhancing user-generated content. With straightforward API calls, the possibilities are endless. Happy coding!

← Back to All Articles