Create Unique Artistic QR Codes with qr2ai Cognitive Actions

24 Apr 2025
Create Unique Artistic QR Codes with qr2ai Cognitive Actions

In today's digital landscape, QR codes have become an essential tool for bridging the physical and digital worlds. The qr2ai/qr_code_ai_art_generator offers a unique opportunity to generate artistic QR codes that not only serve their functional purpose but also add aesthetic value to your applications. With the power of the Stable Diffusion ControlNet model, developers can customize the design of their QR codes using specific prompts. This blog post will guide you through the capabilities of the Generate Artistic QR Code action and how to integrate it into your applications.

Prerequisites

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

  • An API key from the Cognitive Actions platform to authenticate your requests.
  • Basic knowledge of JSON and how to handle API requests in your programming language of choice.

To authenticate, you'll typically pass the API key in the request headers.

Cognitive Actions Overview

Generate Artistic QR Code

The Generate Artistic QR Code action allows you to create stylish QR codes with customizable prompts. Whether you want to generate a QR code for a website or a specific content link, this action enables you to create unique designs that stand out.

  • Category: Image Generation

Input

The input for this action is structured as follows:

{
  "seed": 7649977190,
  "width": 768,
  "border": 2,
  "height": 768,
  "prompt": "surreal concept art of a futuristic house floating on a cloud with waterfall, peaceful and modern, cosy, minimalistic, big windows, natural lighting, sci-fi, lots of details, intricate scene, correct, digital painting, fine tuned, 64k",
  "guidanceScale": 5.7,
  "qrCodeContent": "qr2ai.com",
  "negativePrompt": "Foreboding mystical, unblended, worst quality, normal quality, low quality, low res, blurry, ugly, disfigured, nsfw, people, animal, character, anime",
  "numberOfOutputs": 1,
  "qrCodeBackground": "white",
  "numberOfInferenceSteps": 40,
  "controlnetConditioningScale": 1.11
}
  • Required Fields:
    • prompt: A description guiding the generation of the QR code.
    • qrCodeContent: The URL or content linked by the QR code.
  • Optional Fields:
    • seed: An integer for deterministic outputs. Default is -1 for a random seed.
    • width: Width of the image in pixels (default: 768).
    • border: Size of the QR code border (default: 4, between 0 and 4).
    • height: Height of the image in pixels (default: 768).
    • guidanceScale: Scale factor for classifier-free guidance (default: 7.5).
    • negativePrompt: Specifies undesirable elements in the image.
    • numberOfOutputs: Number of images to generate (default: 1, between 1 and 4).
    • qrCodeBackground: Background color of the QR code (default: white).
    • numberOfInferenceSteps: Number of diffusion steps for image generation (default: 40, between 20 and 100).
    • controlnetConditioningScale: Multiplier applied to ControlNet outputs (default: 1).

Output

Upon successful execution, the action returns a URL pointing to the generated artistic QR code image. Here’s an example of the output:

[
  "https://assets.cognitiveactions.com/invocations/db04b966-2555-4624-81f4-c4215cba0925/3fc8bf32-2516-4d80-b026-2c653f73520c.png"
]

Conceptual Usage Example (Python)

Here’s how you might call this 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 = "70e355f4-091f-48c7-a43a-a0ab80a7a90a"  # Action ID for Generate Artistic QR Code

# Construct the input payload based on the action's requirements
payload = {
    "seed": 7649977190,
    "width": 768,
    "border": 2,
    "height": 768,
    "prompt": "surreal concept art of a futuristic house floating on a cloud with waterfall, peaceful and modern, cosy, minimalistic, big windows, natural lighting, sci-fi, lots of details, intricate scene, correct, digital painting, fine tuned, 64k",
    "guidanceScale": 5.7,
    "qrCodeContent": "qr2ai.com",
    "negativePrompt": "Foreboding mystical, unblended, worst quality, normal quality, low quality, low res, blurry, ugly, disfigured, nsfw, people, animal, character, anime",
    "numberOfOutputs": 1,
    "qrCodeBackground": "white",
    "numberOfInferenceSteps": 40,
    "controlnetConditioningScale": 1.11
}

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, make sure to replace YOUR_COGNITIVE_ACTIONS_API_KEY with your actual API key. The endpoint URL and request structure are illustrative, focusing on how to structure the input payload correctly.

Conclusion

The qr2ai/qr_code_ai_art_generator Cognitive Action provides an exciting way to generate artistic QR codes that are not only functional but also visually appealing. By leveraging the ability to customize prompts and settings, developers can create unique designs tailored to their needs. Whether for marketing materials, product packaging, or digital content, integrating these actions into your applications can enhance user engagement and add a creative touch.

Start experimenting with artistic QR codes today and elevate your application’s visual identity!

← Back to All Articles