Overview
This node integrates with OpenAI's DALL-E models to generate images. Specifically, the "Create Image Variation" operation allows users to create variations of an existing image by providing that image as binary data input. This is useful when you want to explore different versions or styles of a given image without starting from scratch.
Common scenarios include:
- Generating multiple stylistic variations of a product photo for marketing.
- Creating alternative artwork based on an original design.
- Experimenting with different image sizes and formats for creative projects.
For example, you can upload a base image and request 3 variations at 512x512 resolution returned as URLs, which you can then use in your application or workflow.
Properties
| Name | Meaning |
|---|---|
| Image Binary Property | The name of the binary property containing the source image to create variations of. |
| Number of Variations | How many image variations to generate (1 to 10). |
| Size | The size of the generated images. Options: 1024x1024, 256x256, 512x512. |
| Response Format | The format in which the generated images are returned. Options: URL or Base64 JSON. |
Output
The output contains a JSON array where each item corresponds to one generated image variation. Each image object includes either:
- A URL pointing to the generated image if the response format is
url. - A Base64-encoded JSON string representing the image if the response format is
b64_json.
No binary data is output directly by this operation; instead, the image data is provided via these two formats.
Dependencies
- Requires an API key credential for OpenAI's API.
- Needs internet access to call OpenAI's image variation endpoint (
https://api.openai.com/v1/images/variations). - The node expects the input item to contain binary data under the specified binary property name.
Troubleshooting
No binary data exists on item!
This error occurs if the input item does not have any binary data attached. Ensure that the previous node provides binary data.No binary data property "[propertyName]" exists on item!
The specified binary property name does not exist on the input item. Verify the property name matches exactly the binary field containing the image.API authentication errors
If the API key is invalid or missing, the request will fail. Confirm that the OpenAI API key credential is correctly configured.Invalid image format or corrupted binary data
The image must be a valid format supported by OpenAI (e.g., PNG, JPEG). Corrupted or unsupported files will cause errors.