Creates an image given a prompt.
POST /images/generations
Authorizations
Request Body required
object
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
.
The number of images to generate. Must be between 1 and 10. For dall-e-3
, only n=1
is supported.
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
.
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.
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.
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
.
A unique identifier representing your end-user, which can help OpenAI to monitor and detect abuse. Learn more.
Responses
200
OK
object
Represents the url or the content of an image generated by the OpenAI API.
object
The base64-encoded JSON of the generated image, if response_format
is b64_json
.
The URL of the generated image, if response_format
is url
(default).
The prompt that was used to generate the image, if there was any revision to the prompt.