Harness the Power of Image Generation with Dreamshaper ControlNet Actions

23 Apr 2025
Harness the Power of Image Generation with Dreamshaper ControlNet Actions

In today’s digital landscape, generating captivating images from text prompts has become increasingly popular. The Dreamshaper ControlNet API offers developers a powerful toolset for this purpose through its Cognitive Actions. By utilizing the Generate Image Using Dreamshaper Canny ControlNet action, you can create stunning visuals with customizable parameters to enhance both control and quality. This blog post will guide you on how to leverage these capabilities effectively.

Prerequisites

To get started with Dreamshaper ControlNet Cognitive Actions, you will need:

  • API Key: A valid API key for authenticating your requests.
  • Basic Understanding of JSON: Familiarity with JSON format is necessary as you will be constructing input payloads in this format.

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

Cognitive Actions Overview

Generate Image Using Dreamshaper Canny ControlNet

This action utilizes the Dreamshaper Canny ControlNet model to generate images based on text prompts. It allows for a high degree of customization with parameters like seed, strength, and guidance scale, providing developers with the tools necessary for fine-tuning the output.

Input

The input schema for this action requires the following fields:

  • image (string): URI of the input image used in img2img or inpaint mode.
  • prompt (string): Text prompt that guides the image generation.
  • strength (number, default: 0.8): Denoising strength for img2img; 1 indicates complete transformation of the input image.
  • loraScale (number, default: 0.95): Scale for LoRA effects, applicable only with trained models.
  • removeEye (boolean, default: true): If true, removes the eye detail from the canny image.
  • scheduler (string, default: "K_EULER"): The scheduler algorithm used for processing.
  • imageToImage (boolean, default: false): Activates the img2img pipeline.
  • guidanceScale (number, default: 7.5): Scale for classifier-free guidance.
  • conditionScale (number, default: 1.1): Defines the influence of ControlNet on generation.
  • ipAdapterScale (number, default: 1): Adjusts the scale of the IP Adapter.
  • negativePrompt (string): Negative text prompt to guide image generation.
  • numberOfOutputs (integer, default: 1): The number of images to generate (1-4).
  • removeBackground (boolean, default: false): If true, removes the background from the input image.
  • autoGenerateCaption (boolean, default: false): Enables auto-caption generation for input images.
  • generatedCaptionWeight (number, default: 0.5): Weight assigned to the generated caption's influence.
  • numberOfInferenceSteps (integer, default: 30): Specifies the number of denoising steps (1-500).

Example Input:

{
  "image": "https://replicate.delivery/pbxt/JiOTMCHj4oGrTTf8Pg2r7vyI8YdXc5jL2IDyC2SfhuggjYe6/out-0%20%281%29.png",
  "prompt": "In the style of rainbow unicorn painting",
  "strength": 1,
  "loraScale": 0.95,
  "scheduler": "KarrasDPM",
  "imageToImage": true,
  "guidanceScale": 7.5,
  "conditionScale": 0.5,
  "ipAdapterScale": 0.1,
  "negativePrompt": "EasyNegative",
  "numberOfOutputs": 1,
  "removeBackground": true,
  "autoGenerateCaption": true,
  "generatedCaptionWeight": 0.1,
  "numberOfInferenceSteps": 15
}

Output

The output of this action typically consists of an array of generated image URLs. Each URL points to the newly created images based on the provided prompt and parameters.

Example Output:

[
  "https://assets.cognitiveactions.com/invocations/d6f138e3-8d75-45bb-b5e0-9a5817479fd8/8eb3b6f7-9fcf-4de7-bf01-017daad8f46f.png",
  "https://assets.cognitiveactions.com/invocations/d6f138e3-8d75-45bb-b5e0-9a5817479fd8/c3731c2c-879e-40d8-83e4-cc9b05e64f06.png"
]

Conceptual Usage Example (Python)

Here's how you might invoke the Generate Image Using Dreamshaper Canny ControlNet action using Python. This code snippet constructs the input JSON payload and makes a request to a hypothetical Cognitive Actions endpoint.

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 = "58565a4e-93c5-4573-a899-4e47a2beac6b" # Action ID for Generate Image Using Dreamshaper Canny ControlNet

# Construct the input payload based on the action's requirements
payload = {
    "image": "https://replicate.delivery/pbxt/JiOTMCHj4oGrTTf8Pg2r7vyI8YdXc5jL2IDyC2SfhuggjYe6/out-0%20%281%29.png",
    "prompt": "In the style of rainbow unicorn painting",
    "strength": 1,
    "loraScale": 0.95,
    "scheduler": "KarrasDPM",
    "imageToImage": True,
    "guidanceScale": 7.5,
    "conditionScale": 0.5,
    "ipAdapterScale": 0.1,
    "negativePrompt": "EasyNegative",
    "numberOfOutputs": 1,
    "removeBackground": True,
    "autoGenerateCaption": True,
    "generatedCaptionWeight": 0.1,
    "numberOfInferenceSteps": 15
}

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 snippet, the action ID is defined along with the input payload constructed per the action's requirements. The URL and request structure are illustrative, so be sure to adapt them to match your actual endpoint.

Conclusion

The Dreamshaper ControlNet Cognitive Actions provide developers with a robust framework for generating images from text prompts. By utilizing the powerful features of the Generate Image Using Dreamshaper Canny ControlNet action, you can create unique, high-quality images tailored to your specific needs. Explore the possibilities of image generation in your applications by integrating these Cognitive Actions today!

← Back to All Articles