Skip to main content

Create Image Variation

Generates variations of an input image using OpenAI's DALL-E models.

Common Properties​

  • Name - The custom name of the node.
  • Color - The custom color of the node.
  • Delay Before (sec) - Waits in seconds before executing the node.
  • Delay After (sec) - Waits in seconds after executing node.
  • Continue On Error - Automation will continue regardless of any error. The default value is false.
info

If the ContinueOnError property is true, no error is caught when the project is executed, even if a Catch node is used.

Inputs​

  • Connection Id - The connection ID for the OpenAI service.
  • Image Path - File path to the original image to create variations of.

Options​

  • Size - The size of the generated image variations. Options include:
    • 256x256
    • 512x512
    • 1024x1024
  • Number of Images - Number of image variations to generate. Default is 1.
  • Response Format - Format of the response. Options are "URL" or "Base64 JSON".
  • User - A unique identifier representing your end-user.

Output​

  • Images - The generated image variations as a JSON object containing URLs or base64 encoded data.

How It Works​

The Create Image Variation node uses OpenAI's DALL-E models to generate variations of an input image:

  1. Validates the provided Connection Id and image file path
  2. Reads the original image file
  3. Prepares the image variation request with the specified options
  4. Sends the request to the DALL-E model for generating variations
  5. Processes the response and returns the image variations

Requirements​

  • A valid OpenAI API key (Robomotion Credits cannot be used with this node)
  • An active OpenAI connection
  • File path to the original image
  • Read access to the specified image file

Error Handling​

The node will return specific errors in the following cases:

  • Empty or invalid Connection Id
  • Empty or invalid Image Path
  • Invalid option values (number of images, size, etc.)
  • OpenAI API errors
  • File access errors for the image file

Usage Notes​

  • This node does not support Robomotion Credits, only direct OpenAI API keys
  • The default size is 1024x1024
  • The default number of images is 1
  • The response format can be set to return URLs or base64 encoded image data
  • Generated image variations are available for 1 hour when using URL format
  • The user parameter can be used to track usage by end-user
  • Only PNG images are supported for creating variations
  • Image variations maintain the same style and content as the original but with different details