Enhance Your Art with Line Generation: A Guide to cuuupid/sdxl-lineart Actions

24 Apr 2025
Enhance Your Art with Line Generation: A Guide to cuuupid/sdxl-lineart Actions

In today's digital landscape, the ability to create stunning visuals is more important than ever. The cuuupid/sdxl-lineart API offers a powerful Cognitive Action that allows developers to generate high-quality line art images using the SDXL model. This action is finely tuned for precise image output, providing options to control dimensions, prompts, and refinement styles, ensuring customizable artwork tailored to your needs. Whether you're building an art application or enhancing visual content, integrating this action can elevate your projects significantly.

Prerequisites

Before diving into the integration, make sure you have the following ready:

  • An API key for the Cognitive Actions platform to authenticate your requests.
  • Basic knowledge of making API calls, as you'll be working with JSON payloads for input and output.

Authentication typically involves passing your API key in the headers of your requests, allowing secure access to the Cognitive Actions.

Cognitive Actions Overview

Generate Line Art with SDXL

This action generates line art images based on a textual prompt, allowing for detailed customization of the output. Users can specify various parameters, including image dimensions, refinement styles, and more.

  • Category: Image Generation

Input

The input payload for this action requires several fields, each providing specific instructions for the image generation process:

  • mask (optional): URI of the input mask for inpaint mode.
  • seed (optional): Random seed value for image generation.
  • image (optional): URI of the input image for img2img or inpaint mode.
  • width (default: 1024): Width of the generated image in pixels.
  • height (default: 1024): Height of the generated image in pixels.
  • prompt (default: "An astronaut riding a rainbow unicorn"): Textual prompt guiding the image generation.
  • refine (default: "no_refiner"): Style of refinement to apply.
  • loraScale (default: 0.6): LoRA additive scale factor.
  • scheduler (default: "K_EULER"): Type of scheduler to use during the generation process.
  • guidanceScale (default: 7.5): Scaling factor for classifier-free guidance.
  • highNoiseFrac (default: 0.8): Fraction of noise applied for the refinement.
  • applyWatermark (default: true): Whether to apply a watermark to the generated image.
  • negativePrompt (optional): Negative prompt to avoid certain features.
  • promptStrength (default: 0.8): Strength of the prompt in img2img or inpaint modes.
  • numberOfOutputs (default: 1): Number of images to generate.
  • numberOfInferenceSteps (default: 50): Total number of denoising steps during generation.

Example Input:

{
  "width": 1024,
  "height": 1024,
  "prompt": "a line art image of TOK astronaut riding a rainbow unicorn in black and white, thin lines, black background",
  "refine": "no_refiner",
  "loraScale": 0.6,
  "scheduler": "K_EULER",
  "guidanceScale": 7.5,
  "highNoiseFrac": 0.8,
  "applyWatermark": true,
  "negativePrompt": "",
  "promptStrength": 0.8,
  "numberOfOutputs": 1,
  "numberOfInferenceSteps": 50
}

Output

The action typically returns a list of URLs pointing to the generated images. Each URL can be used to access the generated line art.

Example Output:

[
  "https://assets.cognitiveactions.com/invocations/d3664639-4ee4-4ac5-ba74-dcde9d7ad853/7b4009ae-af94-41a2-8481-55aef56f843d.png"
]

Conceptual Usage Example (Python)

Here’s how you might call this Cognitive 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 = "80f7da52-274e-4f62-b0de-52b668ebe7e7"  # Action ID for Generate Line Art with SDXL

# Construct the input payload based on the action's requirements
payload = {
    "width": 1024,
    "height": 1024,
    "prompt": "a line art image of TOK astronaut riding a rainbow unicorn in black and white, thin lines, black background",
    "refine": "no_refiner",
    "loraScale": 0.6,
    "scheduler": "K_EULER",
    "guidanceScale": 7.5,
    "highNoiseFrac": 0.8,
    "applyWatermark": True,
    "negativePrompt": "",
    "promptStrength": 0.8,
    "numberOfOutputs": 1,
    "numberOfInferenceSteps": 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 code snippet, replace "YOUR_COGNITIVE_ACTIONS_API_KEY" with your actual API key. The action ID corresponds to the "Generate Line Art with SDXL" action. The input payload is structured according to the action's schema, and the response is printed nicely in JSON format.

Conclusion

The cuuupid/sdxl-lineart Cognitive Action provides an efficient way to generate custom line art images tailored to your specifications. By leveraging its capabilities, developers can enhance their applications with unique visual content. Explore different prompts, refine styles, and dimensions to create stunning artwork that captures the imagination. Whether for games, illustrations, or educational tools, the possibilities are endless. Start integrating today and unleash your creativity!

← Back to All Articles