# Imagine V4

**Action ID:** `imagine_v4`

## Description

Imagine V4

## 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 |     ✓    | -       | The text prompt describing the image you want to generate. |

<details>

<summary>View JSON Schema</summary>

```json
{
  "description": "Comfy UI node input.",
  "properties": {
    "prompt": {
      "title": "Input your prompt",
      "type": "string"
    }
  },
  "required": [
    "prompt"
  ],
  "title": "GenerateArtV4NodeInput",
  "type": "object"
}
```

</details>

## Output Parameters

| Name  | Type   | Description                 |
| ----- | ------ | --------------------------- |
| image | string | URL to the generated image. |

<details>

<summary>View JSON Schema</summary>

```json
{
  "description": "Comfy UI node output.",
  "properties": {
    "image": {
      "title": "Image output",
      "type": "string"
    }
  },
  "required": [
    "image"
  ],
  "title": "GenerateArtV4NodeOutput",
  "type": "object"
}
```

</details>

## How It Works

This node uses the PixelML V4 AI art generation engine to create images from text descriptions. It processes your text prompt, interprets the visual concepts and styles described, and generates a unique image matching your description. The V4 version incorporates advanced AI models with improved quality, better prompt understanding, and enhanced artistic capabilities. The generated image is uploaded to storage and a URL is returned for access.

## Usage Examples

### Example 1: Photorealistic Image

**Input:**

```
prompt: "A professional photograph of a modern office workspace with large windows overlooking a city skyline, natural lighting, minimalist design, 8k quality"
```

**Output:**

```
image: "https://storage.pixelml.com/generated/workspace_abc123def456.png"
```

### Example 2: Artistic Style

**Input:**

```
prompt: "A surreal digital art painting of a floating island with waterfalls cascading into clouds, vibrant sunset colors, dreamlike atmosphere, detailed"
```

**Output:**

```
image: "https://storage.pixelml.com/generated/floating_island_xyz789.png"
```

### Example 3: Product Visualization

**Input:**

```
prompt: "A sleek modern smartphone on a marble surface, studio lighting, product photography style, reflections, high resolution"
```

**Output:**

```
image: "https://storage.pixelml.com/generated/smartphone_prod_456abc.png"
```

## Common Use Cases

* **Marketing Content**: Generate unique visuals for social media, advertisements, and promotional materials
* **Product Mockups**: Create product visualizations and concept designs
* **Blog and Article Images**: Generate custom illustrations for content marketing
* **Social Media Graphics**: Create engaging visual content for social platforms
* **Concept Art**: Develop visual concepts for creative projects and presentations
* **E-commerce**: Generate product lifestyle images and contextual photography
* **Brand Assets**: Create custom graphics aligned with brand guidelines and aesthetics

## Error Handling

| Error Type               | Cause                                 | Solution                                                            |
| ------------------------ | ------------------------------------- | ------------------------------------------------------------------- |
| Authentication Error     | Invalid or missing PixelML connection | Verify your PixelML connection is properly configured               |
| Empty Prompt             | Prompt parameter is empty             | Provide a descriptive text prompt                                   |
| Generation Failed        | AI model failed to generate image     | Try rephrasing the prompt or simplifying the description            |
| Content Policy Violation | Prompt violates content policy        | Ensure prompt complies with content guidelines and terms of service |
| Rate Limit Exceeded      | Too many generation requests          | Wait before making additional requests or upgrade your plan         |
| Timeout Error            | Image generation took too long        | Retry with a simpler prompt or try again later                      |
| Invalid Prompt           | Prompt contains unsupported elements  | Review prompt for invalid characters or conflicting descriptions    |

## Notes

* **Prompt Quality**: More detailed and specific prompts generally produce better results. Include style, lighting, composition, and quality descriptors.
* **V4 Improvements**: Version 4 offers enhanced image quality, better prompt interpretation, and more consistent results compared to earlier versions.
* **Image Resolution**: Generated images are high-resolution suitable for most digital applications. Check output specifications for exact dimensions.
* **Generation Time**: Image generation typically takes 10-30 seconds depending on complexity and server load.
* **Prompt Engineering**: Use descriptive adjectives, specify artistic styles, mention quality terms (e.g., "8k", "high resolution", "detailed").
* **Content Guidelines**: Ensure your prompts comply with PixelML's acceptable use policy. Avoid generating inappropriate or copyrighted content.
* **Consistent Results**: While the AI aims for consistency, slight variations may occur between generations with the same prompt.
* **Best Practices**: Start with clear, concise prompts. Add details incrementally to refine results. Include style references like "photorealistic", "watercolor", "digital art", etc.


---

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