# Generate Blend V4

**Action ID:** `blend_v4`

## Description

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

## Connection

| Name               | Description                                 | Required | Category |
| ------------------ | ------------------------------------------- | :------: | -------- |
| PixelML Connection | The PixelML connection to call PixelML API. |     ✓    | 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. |
| background\_url  | string  |     ✓    | -        | The URL of the background image.                                                                                                                        |
| qr\_code\_url    | string  |     ✓    | -        | The URL of the QR code image.                                                                                                                           |
| negative\_prompt | string  |     -    | ""       | A blurb of text describing what you do not wish to see in the output image                                                                              |
| qr\_strength     | number  |     -    | 0.5      | The strength of the QR code. Higher values will make the QR code more prominent in the image.                                                           |
| seed             | integer |     -    | 10000000 | The seed of the image for reproducibility.                                                                                                              |
| width            | integer |     -    | 768      | The width of the generated image in pixels.                                                                                                             |
| height           | integer |     -    | 768      | The height of the generated image in pixels.                                                                                                            |
| batch\_size      | integer |     -    | 1        | The number of images to generate.                                                                                                                       |
| caption          | string  |     -    | "object" | What elements to keep from the original image.                                                                                                          |

<details>

<summary>View JSON Schema</summary>

```json
{
  "description": "Blend V4 node 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"
    },
    "background_url": {
      "description": "The URL of the background image.",
      "title": "Background URL",
      "type": "string"
    },
    "qr_code_url": {
      "description": "The URL of the QR code image.",
      "title": "QR code URL",
      "type": "string"
    },
    "qr_strength": {
      "default": 0.5,
      "description": "The strength of the QR code. Higher values will make the QR code more prominent in the image.",
      "title": "QR strength",
      "type": "number"
    },
    "seed": {
      "default": 10000000,
      "description": "The seed of the image.",
      "title": "Seed",
      "type": "integer"
    },
    "width": {
      "default": 768,
      "description": "The width of the image.",
      "title": "Width",
      "type": "integer"
    },
    "height": {
      "default": 768,
      "description": "The height of the image.",
      "title": "Height",
      "type": "integer"
    },
    "batch_size": {
      "default": 1,
      "description": "The number of images to generate.",
      "title": "Batch size",
      "type": "integer"
    },
    "caption": {
      "default": "object",
      "description": "What's to keep?",
      "title": "What's to keep?",
      "type": "string"
    }
  },
  "required": [
    "prompt",
    "background_url",
    "qr_code_url"
  ],
  "title": "BlendV4NodeInput",
  "type": "object"
}
```

</details>

## Output Parameters

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

<details>

<summary>View JSON Schema</summary>

```json
{
  "description": "Blend V4 node output.",
  "properties": {
    "image": {
      "title": "Image output",
      "type": "string"
    }
  },
  "required": [
    "image"
  ],
  "title": "BlendV4NodeOutput",
  "type": "object"
}
```

</details>

## How It Works

This node blends a QR code with a background image using AI-powered artistic generation from Quick Blend V4. It takes your QR code and background image, then applies the prompt to create an aesthetically pleasing artistic QR code that maintains scannability while looking visually appealing. The qr\_strength parameter controls how prominent the QR code pattern remains in the final artistic output, balancing aesthetics with functionality.

## Usage Examples

### Example 1: Creating a Nature-Themed QR Code

**Input:**

```
prompt: "A beautiful forest landscape with trees and sunlight"
background_url: "https://example.com/forest-background.jpg"
qr_code_url: "https://example.com/my-qr-code.png"
qr_strength: 0.6
width: 768
height: 768
```

**Output:**

```
image: "https://pixelml.com/output/artistic-qr-forest-12345.png"
```

### Example 2: Corporate Branding QR Code

**Input:**

```
prompt: "Modern minimalist design with blue and white corporate colors, professional tech aesthetic"
background_url: "https://example.com/brand-background.jpg"
qr_code_url: "https://example.com/company-qr.png"
negative_prompt: "cluttered, messy, unprofessional, colorful"
qr_strength: 0.7
seed: 42
batch_size: 3
```

**Output:**

```
image: "https://pixelml.com/output/artistic-qr-corporate-67890.png"
```

### Example 3: Event Promotional QR Code

**Input:**

```
prompt: "Vibrant music festival atmosphere with neon lights and energy"
background_url: "https://example.com/festival-bg.jpg"
qr_code_url: "https://example.com/event-qr.png"
negative_prompt: "dull, boring, gray"
qr_strength: 0.5
width: 1024
height: 1024
caption: "music notes"
```

**Output:**

```
image: "https://pixelml.com/output/artistic-qr-festival-24680.png"
```

## Common Use Cases

* **Marketing Campaigns**: Create eye-catching QR codes for advertisements, posters, and promotional materials
* **Business Cards**: Generate unique artistic QR codes that reflect your brand identity
* **Event Tickets**: Design memorable QR codes for concerts, conferences, and special events
* **Product Packaging**: Enhance product labels with aesthetically pleasing scannable codes
* **Restaurant Menus**: Create themed QR codes that match restaurant decor and ambiance
* **Social Media Profiles**: Generate shareable artistic QR codes linking to profiles or content
* **Art Installations**: Incorporate functional QR codes into artistic works and exhibitions

## Error Handling

| Error Type         | Cause                                                     | Solution                                                        |
| ------------------ | --------------------------------------------------------- | --------------------------------------------------------------- |
| Invalid Image URL  | Background or QR code URL is inaccessible or malformed    | Verify that both image URLs are valid and publicly accessible   |
| QR Code Too Weak   | qr\_strength value is too low, making QR code unscannable | Increase qr\_strength to 0.6 or higher to maintain scannability |
| Invalid Dimensions | Width or height values are outside acceptable range       | Use dimensions between 512 and 2048 pixels for best results     |
| Generation Timeout | Complex prompt or large batch size causing timeout        | Reduce batch\_size or simplify the prompt                       |
| API Limit Exceeded | Too many requests to PixelML API                          | Wait before making additional requests or check your API quota  |
| Invalid Seed Value | Seed value is outside acceptable range                    | Use a positive integer value for the seed parameter             |
| Poor Blend Quality | Conflicting prompt and background image styles            | Ensure prompt description aligns with background image content  |

## Notes

* **QR Code Scannability**: Always test the generated QR code with multiple scanners to ensure it remains functional. A qr\_strength of 0.6-0.7 typically provides the best balance.
* **Image Quality**: Use high-resolution background images (at least 1024x1024) for best results and clearer QR code integration.
* **Prompt Engineering**: Detailed, descriptive prompts produce better results. Include style, colors, mood, and specific elements you want.
* **Batch Generation**: Use batch\_size to generate multiple variations and select the best one that maintains QR functionality.
* **Seed Reproducibility**: Save the seed value if you want to regenerate the same artistic style with different parameters later.
* **Negative Prompts**: Use negative prompts to avoid unwanted elements that might interfere with QR code readability.
* **Testing**: Always test the final QR code across different devices and scanning apps before using in production.
* **File Format**: The output image is typically in PNG format with transparent background support for better integration.


---

# 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/blend_v4.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.
