Skip to main content

Create Image

Generates images from text prompts 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.
  • Prompt - The text prompt describing the image to generate.

Options​

  • Model - The DALL-E model to use. Options include:
    • dall-e-2
    • dall-e-3
  • Number of Images - Number of images to generate. For dall-e-3 model only n=1 is supported.
  • Quality - Quality setting for image generation (only supported for dall-e-3).
  • Response Format - Format of the response. Options are "URL" or "Base64 JSON".
  • Size - The size of the generated images. Options include:
    • 256x256
    • 512x512
    • 1024x1024
    • 1792x1024
    • 1024x1792
  • Style - Style of the generated images. Options are "vivid" or "natural".
  • User - A unique identifier representing your end-user.

Output​

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

How It Works​

The Create Image node uses OpenAI's DALL-E models to generate images from text descriptions. When executed, the node:

  1. Validates the provided Connection Id and prompt
  2. Prepares the image generation request with the specified prompt and options
  3. Configures all specified options for the model
  4. Sends the request to the selected DALL-E model
  5. Processes the response and returns the generated images

Requirements​

  • A valid OpenAI API key (Robomotion Credits cannot be used with this node)
  • An active OpenAI connection
  • A text prompt describing the desired image

Error Handling​

The node will return specific errors in the following cases:

  • Empty or invalid Connection Id
  • Empty or invalid Prompt
  • Invalid option values (number of images, size, etc.)
  • OpenAI API errors

Usage Notes​

  • This node does not support Robomotion Credits, only direct OpenAI API keys
  • The default model is dall-e-3 which produces higher quality images
  • The default size is 1024x1024
  • For dall-e-3, only 1 image can be generated per request
  • Quality and Style parameters are only supported for dall-e-3
  • The response format can be set to return URLs or base64 encoded image data
  • Generated images are available for 1 hour when using URL format
  • The user parameter can be used to track usage by end-user