Transform Your Images with the pnickolas1/sdxl-coloringbook Cognitive Actions

23 Apr 2025
Transform Your Images with the pnickolas1/sdxl-coloringbook Cognitive Actions

In the realm of image processing, the pnickolas1/sdxl-coloringbook API offers powerful Cognitive Actions that enable developers to create and manipulate images efficiently. One of the standout features is the ability to generate inpainted images, allowing for creative transformations based on user-defined parameters. By leveraging these pre-built actions, you can enhance your applications with advanced image processing capabilities without the need for complex implementations.

Prerequisites

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

  • An API key for the Cognitive Actions platform.
  • Basic knowledge of handling HTTP requests in your preferred programming language.
  • Familiarity with JSON structures, as the API expects data in this format.

Authentication typically involves passing your API key in the request headers to authorize access to the actions.

Cognitive Actions Overview

Generate Inpainted Image

The Generate Inpainted Image action creates an inpainted image based on specified input masks. This feature preserves black areas in the input mask while filling in white areas to generate new content. It's a versatile tool for customizing images, optimizing for dimensions, prompt strength, and refinement methods.

Input

The action accepts the following parameters structured in a JSON object:

{
  "mask": "https://example.com/mask.png",
  "image": "https://example.com/input_image.png",
  "width": 1024,
  "height": 1024,
  "prompt": "An princess in the woods in the style of TOK, black and white coloring page",
  "refine": "no_refiner",
  "loraScale": 0.6,
  "scheduler": "K_EULER",
  "numOutputs": 1,
  "guidanceScale": 7.5,
  "highNoiseFrac": 0.8,
  "applyWatermark": true,
  "negativePrompt": "",
  "promptStrength": 0.8,
  "numInferenceSteps": 50
}

Required Fields:

  • mask: URI of the input mask for inpainting.
  • image: URI of the input image.
  • prompt: Descriptive text for image generation.

Optional Fields:

  • seed: Random seed for generation.
  • width: Width of the output image (default: 1024).
  • height: Height of the output image (default: 1024).
  • refine: Refinement style (options: "no_refiner", "expert_ensemble_refiner", "base_image_refiner").
  • Other parameters like loraScale, scheduler, and applyWatermark allow for further customization.

Output

The action typically returns a JSON array containing the URI of the generated image. For example:

[
  "https://assets.cognitiveactions.com/invocations/ced111c5-852b-4f57-98f2-119911aa0879/0d2c0419-0cf1-4121-8e42-afb43dd55115.png"
]

Conceptual Usage Example (Python)

Here's a conceptual Python snippet illustrating how to call the Generate Inpainted Image action:

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 = "19a5bc23-2e58-4561-a69e-8cf3c5e644b7" # Action ID for Generate Inpainted Image

# Construct the input payload based on the action's requirements
payload = {
    "mask": "https://example.com/mask.png",
    "image": "https://example.com/input_image.png",
    "width": 1024,
    "height": 1024,
    "prompt": "An princess in the woods in the style of TOK, black and white coloring page",
    "refine": "no_refiner",
    "loraScale": 0.6,
    "scheduler": "K_EULER",
    "numOutputs": 1,
    "guidanceScale": 7.5,
    "highNoiseFrac": 0.8,
    "applyWatermark": True,
    "negativePrompt": "",
    "promptStrength": 0.8,
    "numInferenceSteps": 50
}

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 the API key and endpoint with your actual values. The action ID and input payload are structured to match the requirements, allowing for seamless integration.

Conclusion

The pnickolas1/sdxl-coloringbook Cognitive Actions offer developers an innovative way to manipulate and generate images. By utilizing the Generate Inpainted Image action, you can create customized visual content that enhances user experiences and application functionalities. Explore these actions further to unlock the full potential of your image-processing endeavors!

← Back to All Articles