# Generate QR Art V6

**Action ID:** `qr_art_v6`

## Description

Unleash Artistic QR Codes: Generate stunning AI-powered QR art with Quick QR Art V6 (powered by <https://quickqr.art>)

## Connection

| Name               | Description                                 | Required | Category |
| ------------------ | ------------------------------------------- | -------- | -------- |
| PixelML Connection | The PixelML connection to call PixelML API. | True     | pixelml  |

## Input Parameters

| Name             | Type   | Required | Default | Description                                                                                                                                             |
| ---------------- | ------ | :------: | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| prompt           | string |     ✓    | -       | What you wish to see in the output image. A strong, descriptive prompt that clearly defines elements, colors, and subjects will lead to better results. |
| negative\_prompt | string |     -    | ""      | A blurb of text describing what you do not wish to see in the output image                                                                              |
| qr\_content      | string |     ✓    | -       | The content you wish to encode in the QR code (URL, text, etc.)                                                                                         |
| qr\_strength     | number |     -    | 1.6     | The strength of the QR code. Higher values make the QR code more prominent in the image.                                                                |
| resolution       | string |     -    | SD      | Select the resolution of the image: `SD`, `HD`, or `FullHD`                                                                                             |
| aspect\_ratio    | string |     -    | 1:1     | The aspect ratio of the generated image: `1:1`, `3:4`, `4:3`, `9:16`, or `16:9`                                                                         |
| qr\_position     | string |     -    | center  | Select the position of the QR code: `center`, `top`, `bottom`, `left`, `right`, `top-left`, `top-right`, `bottom-left`, or `bottom-right`               |
| qr\_pattern      | string |     -    | s1      | Select the QR pattern: `s1`, `s2`, `s3`, `rd1`, `rd2`, `rd3`, `d1`, `d2`, `d3`, `r1`, `r2`, `r3`, `c1`, `c2`, `c3`, `sq1`, `sq2`, `sq3`                 |

<details>

<summary>View JSON Schema</summary>

```json
{
  "description": "QR Art V6 action input.",
  "properties": {
    "prompt": {
      "description": "What you wish to see in the output image. A strong, descriptive prompt that clearly defines elements, colors, and subjects will lead to better results.",
      "title": "Prompt",
      "type": "string"
    },
    "negative_prompt": {
      "default": "",
      "description": "A blurb of text describing what you do not wish to see in the output image",
      "title": "Negative prompt",
      "type": "string"
    },
    "qr_content": {
      "description": "The content you wish to encode in the QR code.",
      "title": "Input your QR content (URL, text, etc.)",
      "type": "string"
    },
    "qr_strength": {
      "default": 1.6,
      "description": "The strength of the QR code. Higher values will make the QR code more prominent in the image.",
      "title": "QR strength",
      "type": "number"
    },
    "resolution": {
      "default": "SD",
      "description": "Select the resolution of the image.",
      "enum": [
        "SD",
        "HD",
        "FullHD"
      ],
      "title": "Resolution",
      "type": "string"
    },
    "aspect_ratio": {
      "default": "1:1",
      "description": "The aspect ratio of the generated image.",
      "enum": [
        "1:1",
        "3:4",
        "4:3",
        "9:16",
        "16:9"
      ],
      "title": "Aspect ratio",
      "type": "string"
    },
    "qr_position": {
      "default": "center",
      "description": "Select the position of the QR code.",
      "enum": [
        "center",
        "top",
        "bottom",
        "left",
        "right",
        "top-left",
        "top-right",
        "bottom-left",
        "bottom-right"
      ],
      "title": "QR position",
      "type": "string"
    },
    "qr_pattern": {
      "default": "s1",
      "description": "Select the QR pattern.",
      "enum": [
        "s1",
        "s2",
        "s3",
        "rd1",
        "rd2",
        "rd3",
        "d1",
        "d2",
        "d3",
        "r1",
        "r2",
        "r3",
        "c1",
        "c2",
        "c3",
        "sq1",
        "sq2",
        "sq3"
      ],
      "title": "QR pattern",
      "type": "string"
    }
  },
  "required": [
    "prompt",
    "qr_content"
  ],
  "title": "QRArtV6ActionInput",
  "type": "object"
}
```

</details>

## Output Parameters

| Name  | Type   | Description                              |
| ----- | ------ | ---------------------------------------- |
| image | string | The generated artistic QR code image URL |

<details>

<summary>View JSON Schema</summary>

```json
{
  "description": "QR Art V6 action output.",
  "properties": {
    "image": {
      "description": "The generated image.",
      "title": "Image output",
      "type": "string"
    }
  },
  "required": [
    "image"
  ],
  "title": "QRArtV6ActionOutput",
  "type": "object"
}
```

</details>

## How It Works

This node generates artistic QR codes by combining AI image generation with functional QR code encoding. Your prompt and QR content are processed by the Quick QR Art V6 AI model (via PixelML), which creates a visually appealing image that incorporates the QR code pattern seamlessly into the artwork. The AI balances aesthetic quality with QR code scannability using the specified strength, pattern, and position parameters. The result is a unique, scannable QR code that doubles as eye-catching artwork.

## Usage Examples

### Example 1: Restaurant Menu QR Code

**Input:**

```
prompt: "elegant italian restaurant interior, warm lighting, rustic wooden tables, wine bottles"
qr_content: "https://restaurant.com/menu"
qr_strength: 1.6
resolution: "HD"
aspect_ratio: "1:1"
qr_position: "center"
```

**Output:**

```
image: "https://storage.pixelml.com/qr-art/restaurant-menu-qr.jpg"
```

### Example 2: Product Packaging QR Code

**Input:**

```
prompt: "modern tech product packaging, sleek metallic surface, blue and silver colors, futuristic design"
negative_prompt: "blurry, low quality, distorted"
qr_content: "https://product.com/register"
qr_strength: 1.8
resolution: "FullHD"
aspect_ratio: "1:1"
qr_pattern: "sq1"
```

**Output:**

```
image: "https://storage.pixelml.com/qr-art/product-qr.jpg"
```

### Example 3: Event Poster QR Code

**Input:**

```
prompt: "vibrant music festival poster, colorful abstract patterns, energetic atmosphere"
qr_content: "https://tickets.com/summer-fest-2024"
qr_strength: 1.4
resolution: "HD"
aspect_ratio: "3:4"
qr_position: "bottom"
qr_pattern: "c2"
```

**Output:**

```
image: "https://storage.pixelml.com/qr-art/festival-poster-qr.jpg"
```

## Common Use Cases

* **Marketing Materials**: Create visually appealing QR codes for posters, flyers, and print advertisements that attract attention and drive scans
* **Product Packaging**: Design branded QR codes that blend seamlessly with product packaging aesthetics while providing registration or info links
* **Business Cards**: Generate artistic QR codes for business cards that stand out and encode contact information or portfolio URLs
* **Restaurant Menus**: Create themed QR codes for digital menus that match restaurant branding and ambiance
* **Event Ticketing**: Design event-specific QR codes that serve as both tickets and promotional artwork
* **Social Media**: Generate shareable artistic QR codes for Instagram, Facebook, or LinkedIn profiles that increase engagement
* **Retail Displays**: Create in-store QR codes for product information, reviews, or promotions that complement store design

## Error Handling

| Error Type           | Cause                                        | Solution                                                                        |
| -------------------- | -------------------------------------------- | ------------------------------------------------------------------------------- |
| Invalid Connection   | PixelML connection not configured or expired | Verify your PixelML connection credentials and ensure the API key is valid      |
| Empty Prompt         | No prompt provided for image generation      | Provide a descriptive prompt that defines the desired visual style and elements |
| Invalid QR Content   | QR content is empty or too long for encoding | Ensure QR content is provided and doesn't exceed QR code capacity limits        |
| Invalid Resolution   | Resolution value not in allowed list         | Use only "SD", "HD", or "FullHD"                                                |
| Invalid Aspect Ratio | Aspect ratio not supported                   | Choose from: "1:1", "3:4", "4:3", "9:16", or "16:9"                             |
| Invalid QR Pattern   | Pattern code not recognized                  | Select a valid pattern from s1-s3, rd1-rd3, d1-d3, r1-r3, c1-c3, or sq1-sq3     |
| Generation Timeout   | AI model took too long to process            | Retry the request or simplify the prompt                                        |
| Insufficient Credits | Not enough PixelML credits available         | Check your PixelML account balance and add credits if needed                    |

## Notes

* **QR Strength Balance**: The qr\_strength parameter (default 1.6) balances aesthetics vs. scannability. Lower values (1.0-1.5) create more artistic images but may be harder to scan, while higher values (1.7-2.0) prioritize scannability
* **Prompt Quality**: Use detailed, specific prompts with clear descriptions of colors, styles, and elements for best results. Vague prompts may produce unpredictable artistic interpretations
* **Negative Prompts**: Use negative\_prompt to exclude unwanted elements like "blurry, distorted, low quality, text, watermark"
* **Resolution Selection**: SD is faster and cheaper, HD provides good quality for most uses, FullHD is best for large prints and detailed artwork
* **Pattern Varieties**: Different patterns (s=standard, rd=rounded, d=diamond, r=rounded corners, c=circular, sq=square) create distinct visual styles
* **Position Flexibility**: QR position affects composition - "center" works universally, corner positions work well for business cards and packaging
* **Testing Scannability**: Always test generated QR codes with multiple scanner apps and devices to ensure they scan reliably before production use
* **Content Length**: Shorter QR content (URLs, text) produces simpler QR patterns that integrate better into artwork. Use URL shorteners for long links


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.agenticflow.ai/reference/nodes/qr_art_v6.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
