openai_image_generation

Beta

Available in: Cloud, Self-Managed

Generates an image from a text description and other attributes, using OpenAI API.

  • Common

  • Advanced

# Common config fields, showing default values
label: ""
openai_image_generation:
  server_address: https://api.openai.com/v1
  api_key: "" # No default (required)
  model: dall-e-3 # No default (required)
  prompt: "" # No default (optional)
# All config fields, showing default values
label: ""
openai_image_generation:
  server_address: https://api.openai.com/v1
  api_key: "" # No default (required)
  model: dall-e-3 # No default (required)
  prompt: "" # No default (optional)
  quality: standard # No default (optional)
  size: 1024x1024 # No default (optional)
  style: vivid # No default (optional)

This processor sends an image description and other attributes, such as image size and quality to the OpenAI API, which generates an image. By default, the processor submits the entire payload of each message as a string, unless you use the prompt configuration field to customize it.

To learn more about image generation, see the OpenAI API documentation.

Fields

server_address

The Open API endpoint that the processor sends requests to. Update the default value to use another OpenAI compatible service.

Type: string

Default: "https://api.openai.com/v1"

api_key

The API key for OpenAI API.

This field contains sensitive information that usually shouldn’t be added to a configuration directly. For more information, see Manage Secrets before adding it to your configuration.

Type: string

model

The name of the OpenAI model to use.

Type: string

# Examples

model: dall-e-3

model: dall-e-2

prompt

A text description of the image you want to generate. The prompt field accepts a maximum of 1000 characters for dall-e-2 and 4000 characters for dall-e-3.

Type: string

quality

The quality of the image to generate. Use hd to create images with finer details and greater consistency across the image. This parameter is only supported for dall-e-3 models. This field supports interpolation functions.

Type: string

# Examples

quality: standard

quality: hd

size

The size of the generated image. Choose from 256x256, 512x512, or 1024x1024 for dall-e-2. Choose from 1024x1024, 1792x1024, or 1024x1792 for dall-e-3 models. This field supports interpolation functions.

Type: string

# Examples

size: 1024x1024

size: 512x512

size: 1792x1024

size: 1024x1792

style

The style of the generated image. Choose from vivid or natural. Vivid causes the model to lean towards generating hyperreal and dramatic images. Natural causes the model to produce more natural, less hyperreal looking images. This parameter is only supported for dall-e-3. This field supports interpolation functions.

Type: string

# Examples

style: vivid

style: natural