Generate Visually Stunning QR Codes with zylim0702/qr_code_controlnet Actions

23 Apr 2025
Generate Visually Stunning QR Codes with zylim0702/qr_code_controlnet Actions

In today's digital landscape, QR codes have become essential tools for linking physical objects to digital content seamlessly. The zylim0702/qr_code_controlnet API offers powerful Cognitive Actions that allow developers to generate visually appealing QR codes using sophisticated models. These actions leverage ControlNet technology, trained on a vast dataset of 150,000 QR code-artwork pairs, providing customization options and ease of integration.

This article will guide you through the Generate QR Code with ControlNet action, detailing how to utilize it effectively in your applications.

Prerequisites

Before you start integrating these Cognitive Actions into your application, ensure you have the following:

  • An API key for the Cognitive Actions platform, which will be used for authentication.
  • Familiarity with JSON format, as the input and output data will be in this structure.
  • Basic knowledge of making HTTP requests in your preferred programming language.

Authentication typically involves passing your API key in the request headers to access the Cognitive Actions endpoint.

Cognitive Actions Overview

Generate QR Code with ControlNet

Purpose

The Generate QR Code with ControlNet action allows you to create QR codes from URLs while customizing their visual appearance through text prompts. This action is particularly useful for marketing materials, event promotions, or any scenario where a unique QR code can enhance user engagement.

Input

The action requires the following fields in the input JSON payload:

  • prompt (required): A textual description of the desired output (e.g., "a city view with clouds").
  • linkUrl (required): The URL to encode in the QR code.

Additional optional parameters include:

  • seed: Integer seed for random number generation.
  • guessMode: Boolean to enable recognition mode.
  • scheduler: String to select the scheduling algorithm (default: "DDIM").
  • guidanceScale: Affects the influence of the prompt (default: 9, range: 0.1 - 30).
  • negativePrompt: Text to specify characteristics to avoid in the output.
  • imageResolution: Specifies output image resolution (options: 256, 512, 768; default: 768).
  • numberOfOutputs: Number of images to generate (default: 1; range: 1 - 10).
  • disableSafetyCheck: Option to disable safety checks (default: false).
  • qrConditioningScale: Adjusts the influence of ControlNet conditioning for QR codes (default: 1).
  • estimatedTimeOfArrival: Level of added noise during the denoising diffusion process.
  • numberOfInferenceSteps: Steps for the denoising process (default: 20).

Example Input:

{
  "prompt": "a city view with clouds",
  "linkUrl": "Hello, World",
  "guessMode": false,
  "scheduler": "DDIM",
  "guidanceScale": 9,
  "negativePrompt": "Longbody, lowres, bad anatomy, bad hands, missing fingers, extra digit, fewer digits, cropped, worst quality, low quality",
  "imageResolution": 768,
  "numberOfOutputs": 1,
  "disableSafetyCheck": false,
  "qrConditioningScale": 1.3,
  "numberOfInferenceSteps": 20
}

Output

Upon successful execution, the action returns a URL link to the generated QR code image.

Example Output:

[
  "https://assets.cognitiveactions.com/invocations/e1cb9188-3f77-418b-8f95-f565e4d17554/f0cc2a7d-2d32-4ee2-af4b-f878535aa0e8.png"
]

Conceptual Usage Example (Python)

Here's a conceptual example of how to invoke the Generate QR Code with ControlNet 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 = "ef0fe42b-cbb7-4a8e-99eb-a9bc417e6e9b" # Action ID for Generate QR Code with ControlNet

# Construct the input payload based on the action's requirements
payload = {
    "prompt": "a city view with clouds",
    "linkUrl": "Hello, World",
    "guessMode": False,
    "scheduler": "DDIM",
    "guidanceScale": 9,
    "negativePrompt": "Longbody, lowres, bad anatomy, bad hands, missing fingers, extra digit, fewer digits, cropped, worst quality, low quality",
    "imageResolution": 768,
    "numberOfOutputs": 1,
    "disableSafetyCheck": False,
    "qrConditioningScale": 1.3,
    "numberOfInferenceSteps": 20
}

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 should correspond to the action we're invoking. The input JSON payload is structured based on the requirements discussed earlier. This example also includes error handling to ensure that any issues during execution are reported clearly.

Conclusion

The Generate QR Code with ControlNet action provides an innovative way to create customized QR codes that are both functional and visually appealing. By leveraging the powerful capabilities of this API, developers can enhance user experiences and engage audiences more effectively.

Consider how you might incorporate these QR codes into your applications, whether for marketing campaigns, event promotions, or enhancing product packaging. Start experimenting with the Cognitive Actions today!

← Back to All Articles