image-generation

Create Stunning Images with Canny Edge Guidance in Flux Canny Dev

26 Apr 2025
Create Stunning Images with Canny Edge Guidance in Flux Canny Dev

In the world of digital art and design, the ability to generate visually compelling images quickly and efficiently is invaluable. The Flux Canny Dev service provides developers with the tools to create detailed and stylistic images through its innovative Canny edge-guided generation feature. By leveraging advanced models, this service allows you to input a simple sketch or edge map alongside a descriptive prompt, enabling precise control over the image's structure and composition.

Using Flux Canny Dev, developers can seamlessly integrate powerful image generation capabilities into their applications, leading to enhanced creative workflows and unique artistic outputs. This service is particularly beneficial for artists, designers, and content creators looking to produce high-quality images without extensive manual effort.

Prerequisites

To get started with Flux Canny Dev, you will need a Cognitive Actions API key and a basic understanding of making API calls.

Generate Image with Canny Edge Guidance

Purpose

The "Generate Image with Canny Edge Guidance" action allows you to create intricate images based on edge maps while incorporating stylistic elements specified through prompts. This action effectively solves the challenge of generating high-quality images that adhere closely to user-defined structures and styles.

Input Requirements

To utilize this action, you must provide the following inputs:

  • controlImage: A URL pointing to an image that will influence the generation process. The system will apply Canny edge detection to this image.
  • prompt: A descriptive text prompt that guides the content and style of the generated image (e.g., "A red vintage convertible driving through an old town").
  • seed (optional): A random seed for reproducible outputs.
  • guidance (optional): A parameter that adjusts the adherence to the prompt, ranging from 0 to 100.
  • megapixels (optional): Specifies the desired image size.
  • outputFormat (optional): The desired file format of the output image (e.g., 'webp', 'jpg', 'png').
  • outputQuality (optional): The quality level of the output image.
  • numberOfOutputs (optional): The number of images to generate (between 1 and 4).
  • disableSafetyChecker (optional): Option to enable or disable the safety checker for generated images.
  • numberOfInferenceSteps (optional): The number of steps used during the denoising process.

Expected Output

The output of this action will be a URL pointing to the generated image, which will reflect the input parameters provided. For example, you may receive an image URL that looks like this:

  • https://assets.cognitiveactions.com/invocations/b1956c0d-fa60-46cb-955b-5bac86b36e0d/598b9516-c5d6-4323-af51-925f1c86de56.webp

Use Cases for this Action

  1. Art Creation: Artists can utilize this action to generate unique artworks based on initial sketches, experimenting with different styles and compositions.
  2. Design Prototyping: Designers can quickly create visual prototypes for client presentations, allowing for rapid iterations based on feedback.
  3. Content Generation: Content creators can automate the generation of images for blogs, social media, or marketing materials, saving time while ensuring high-quality outputs.
import requests
import json

# Replace with your actual Cognitive Actions API key and endpoint
# Ensure your environment securely handles the API key
COGNITIVE_ACTIONS_API_KEY = "YOUR_COGNITIVE_ACTIONS_API_KEY"
# This endpoint URL is hypothetical and should be documented for users
COGNITIVE_ACTIONS_EXECUTE_URL = "https://api.cognitiveactions.com/actions/execute"

action_id = "038b2aaa-8fb4-4d8a-91b6-a4deba8e2627" # Action ID for: Generate Image with Canny Edge Guidance

# Construct the exact input payload based on the action's requirements
# This example uses the predefined example_input for this action:
payload = {
  "prompt": "A red vintage convertible driving through an old town",
  "guidance": 30,
  "megapixels": "1",
  "controlImage": "https://replicate.delivery/pbxt/M0mUcvKOwNSS4axvv7LAngBAR5Iuv2GsIcnSKdpQRJA62f8G/Screenshot%202024-11-21%20at%2016.08.20.png",
  "outputFormat": "webp",
  "outputQuality": 80,
  "numberOfOutputs": 1,
  "numberOfInferenceSteps": 28
}

headers = {
    "Authorization": f"Bearer {COGNITIVE_ACTIONS_API_KEY}",
    "Content-Type": "application/json",
    # Add any other required headers for the Cognitive Actions API
}

# Prepare the request body for the hypothetical execution endpoint
request_body = {
    "action_id": action_id,
    "inputs": payload
}

print(f"--- Calling Cognitive Action: {action.name or action_id} ---")
print(f"Endpoint: {COGNITIVE_ACTIONS_EXECUTE_URL}")
print(f"Action ID: {action_id}")
print("Payload being sent:")
print(json.dumps(request_body, indent=2))
print("------------------------------------------------")

try:
    response = requests.post(
        COGNITIVE_ACTIONS_EXECUTE_URL,
        headers=headers,
        json=request_body
    )
    response.raise_for_status() # Raise an exception for bad status codes (4xx or 5xx)

    result = response.json()
    print("Action executed successfully. Result:")
    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 (non-JSON): {e.response.text}")
    print("------------------------------------------------")

Conclusion

The Flux Canny Dev service, particularly through its Canny edge-guided image generation action, presents an exciting opportunity for developers to elevate their applications with advanced image creation capabilities. By simplifying the process of generating high-quality images from sketches and prompts, this service not only enhances creative workflows but also opens up new avenues for artistic expression.

As you explore the possibilities within Flux Canny Dev, consider how these tools can be integrated into your projects to streamline image production, improve visual content quality, and ultimately enrich user experiences. Start experimenting with your own image generation today!

← Back to All Articles