Skip to content
Lucero

Creates an image given a prompt.

POST
/images/generations

Authorizations

Request Body required

object
prompt
required

A text description of the desired image(s). The maximum length is 1000 characters for dall-e-2 and 4000 characters for dall-e-3.

string
A cute baby sea otter
model
Any of:
string
n

The number of images to generate. Must be between 1 and 10. For dall-e-3, only n=1 is supported.

integer
default: 1 nullable >= 1 <= 10 
1
quality

The quality of the image that will be generated. hd creates images with finer details and greater consistency across the image. This param is only supported for dall-e-3.

string
default: standard
Allowed values: standard hd 
standard
response_format

The format in which the generated images are returned. Must be one of url or b64_json. URLs are only valid for 60 minutes after the image has been generated.

string
default: url nullable
Allowed values: url b64_json 
url
size

The size of the generated images. Must be one of 256x256, 512x512, or 1024x1024 for dall-e-2. Must be one of 1024x1024, 1792x1024, or 1024x1792 for dall-e-3 models.

string
default: 1024x1024 nullable
Allowed values: 256x256 512x512 1024x1024 1792x1024 1024x1792 
1024x1024
style

The style of the generated images. Must be one of vivid or natural. Vivid causes the model to lean towards generating hyper-real and dramatic images. Natural causes the model to produce more natural, less hyper-real looking images. This param is only supported for dall-e-3.

string
default: vivid nullable
Allowed values: vivid natural 
vivid
user

A unique identifier representing your end-user, which can help OpenAI to monitor and detect abuse. Learn more.

string
user-1234

Responses

200

OK

object
created
required
integer
data
required
Array<object>

Represents the url or the content of an image generated by the OpenAI API.

object
b64_json

The base64-encoded JSON of the generated image, if response_format is b64_json.

string
url

The URL of the generated image, if response_format is url (default).

string
revised_prompt

The prompt that was used to generate the image, if there was any revision to the prompt.

string