Overview
This node integrates with the Automatic1111 API to generate images using Stable Diffusion models. It supports two main operations: generating images from text prompts ("Text to Image") and generating images based on an input image plus a text prompt ("Image to Image"). Additionally, it allows setting the active Stable Diffusion model.
Typical use cases include:
- Creating artwork or concept images from descriptive text prompts.
- Enhancing or modifying existing images guided by textual descriptions.
- Automating creative workflows where AI-generated imagery is needed.
For example, a user can input a detailed description of a fantasy landscape and receive generated images matching that description, or provide a base image and modify its style or content via a text prompt.
Properties
| Name | Meaning |
|---|---|
| Text Prompt | The main text description used to generate the image. |
| Options | A collection of optional parameters controlling image generation details: |
| - Batch Size | Number of images to generate in one batch (1 to 10). |
| - CFG Scale | Classifier-Free Guidance scale, controls adherence to the prompt (1 to 30, decimal allowed). |
| - Image Height | Height of the generated image in pixels (16 to 4096). |
| - Image Width | Width of the generated image in pixels (64 to 4096). |
| - Negative Prompt | Text describing what should be avoided in the generated image. |
| - Seed | Random seed for reproducibility; -1 means random seed. |
| - Steps | Number of diffusion steps to run (minimum 1), affecting quality and generation time. |
Output
The node outputs JSON data representing the response from the Automatic1111 API after image generation. This typically includes metadata about the generated images and the images themselves encoded in base64 format within the JSON.
If binary output is supported (not explicitly shown in the code snippet), it would represent the generated images as binary data suitable for further processing or saving.
Dependencies
- Requires connection to an Automatic1111 API endpoint, which must be configured with a valid URL and API key credential.
- The node depends on the availability and responsiveness of the Automatic1111 Stable Diffusion server.
- Network access and proper authentication credentials are necessary for successful operation.
Troubleshooting
Common Issues:
- Incorrect or unreachable API URL: Ensure the Automatic1111 API URL is correctly set and accessible.
- Invalid or missing API credentials: Verify that the required API key or token is provided.
- Parameter validation errors: Check that numeric inputs like batch size, image dimensions, and steps fall within allowed ranges.
- Large image sizes or high step counts may cause timeouts or memory issues on the server.
Error Messages:
- HTTP errors (e.g., 401 Unauthorized, 404 Not Found): Indicate credential or endpoint misconfiguration.
- Validation errors from the API: Usually specify which parameter is invalid or out of range.
- Timeout or network errors: Suggest connectivity problems or server overload.
Resolving these generally involves verifying configuration settings, adjusting input parameters, and ensuring the Automatic1111 server is operational.
Links and References
- Automatic1111 Web UI GitHub Repository
- Stable Diffusion Documentation
- n8n Expressions Documentation (for dynamic property values)