Enhance Your Image Generation with the Flux Canny Pro Cognitive Actions

24 Apr 2025
Enhance Your Image Generation with the Flux Canny Pro Cognitive Actions

In the world of digital design and content creation, image generation has become an essential tool for developers and artists alike. The black-forest-labs/flux-canny-pro API offers a set of powerful Cognitive Actions aimed at streamlining image generation processes. Among these, the Generate Edge-Guided Image action stands out, providing precise control over image structure and composition through Canny edge detection. This capability is particularly beneficial for applications involving sketch conversion, retexturing, and architectural visualization.

Prerequisites

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

  • An API key for accessing the Cognitive Actions platform.
  • Basic knowledge of JSON and RESTful APIs, as the integration will involve sending structured requests and handling responses.

Authentication typically involves passing your API key in the headers of your HTTP requests, allowing you to securely connect to the services offered.

Cognitive Actions Overview

Generate Edge-Guided Image

The Generate Edge-Guided Image action utilizes Canny edge detection to create high-quality images based on a given control image and text prompt. This action allows developers to generate images with a focus on structural accuracy and creative interpretation.

  • Category: Image Generation

Input

The input for this action requires several fields, including both mandatory and optional parameters:

  • controlImage (string, required): URL of the control image to guide generation. Accepted formats include jpeg, png, gif, or webp.
  • prompt (string, required): Text prompt that guides the image generation process.
  • seed (integer, optional): Specifies a random seed for consistent image generation.
  • steps (integer, optional): The number of diffusion steps used in generation, with a valid range of 15 to 50. Default is 50.
  • guidance (number, optional): Adjusts the balance between prompt adherence and image quality. Valid range: 1 to 100. Default is 30.
  • imageFormat (string, optional): Specifies the format of the output images. Options are 'jpg' or 'png', with 'jpg' as the default.
  • safetyTolerance (integer, optional): Sets the level of safety filtering, with 1 being the most strict and 6 being the most permissive. Default is 2.
  • promptUpsampling (boolean, optional): If true, enhances the prompt for more creative image generation. Default is false.
Example Input
{
  "steps": 28,
  "prompt": "a photo of a car on a city street",
  "guidance": 25,
  "imageFormat": "jpg",
  "controlImage": "https://replicate.delivery/pbxt/M0j11UQhwUWoxUQ9hJCOaALsAHTeoPZcGGtUf6n3BJxtKHul/output-14.webp",
  "safetyTolerance": 2,
  "promptUpsampling": false
}

Output

Upon execution, the action typically returns a URL to the generated image. Here is an example of what the output might look like:

"https://assets.cognitiveactions.com/invocations/47085414-b922-47b9-9d9d-9bc56a6c7705/fd51d9c8-93fe-49ce-9d46-df592cd85a41.jpg"

Conceptual Usage Example (Python)

To integrate the Generate Edge-Guided Image action into your application, you can use the following Python code snippet. This example demonstrates how to structure your input payload and make a request to the hypothetical Cognitive Actions execution 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 = "f19472de-eeb3-483d-bd18-1fc3fc138505"  # Action ID for Generate Edge-Guided Image

# Construct the input payload based on the action's requirements
payload = {
    "steps": 28,
    "prompt": "a photo of a car on a city street",
    "guidance": 25,
    "imageFormat": "jpg",
    "controlImage": "https://replicate.delivery/pbxt/M0j11UQhwUWoxUQ9hJCOaALsAHTeoPZcGGtUf6n3BJxtKHul/output-14.webp",
    "safetyTolerance": 2,
    "promptUpsampling": False
}

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 and input payload are structured according to the requirements of the Generate Edge-Guided Image action.

Conclusion

The black-forest-labs/flux-canny-pro Cognitive Actions provide developers with advanced tools to enhance image generation capabilities in their applications. By leveraging the Generate Edge-Guided Image action, you can create stunning visuals that adhere closely to specified prompts while maintaining high quality and control over the output. Explore these actions further to unlock creative possibilities in your projects!

← Back to All Articles