Create image

POST

https://api.openai.com/v1/images/generations

Given a prompt and/or an input image, the model will generate a new image.

Related guide: Image generation

Creates an image given a prompt.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.openai.com/v1/images/generations' \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data-raw '{
  "prompt": "A colorful sunset over the mountains",
  "n": 2,
  "size": "1024x1024"
}'

Response Example

{
  "created": 1589478378,
  "data": [
    {
      "url": "https://..."
    },
    {
      "url": "https://..."
    }
  ]
}

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Header Params

Authorization

string

optional

Example:

Bearer {{YOUR_API_KEY}}

Body Params application/json

prompt

string

required

A text description of the desired image(s). The maximum length is 1000 characters.

integer

optional

The number of images to generate. Must be between 1 and 10.

size

string

optional

The size of the generated images. Must be one of 256x256, 512x512, or 1024x1024.

response_format

string

required

The format in which the generated images are returned. Must be one of url or b64_json.

user

string

required

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

Examples

Responses

🟢200Create image

application/json

Body

created

integer

required

data

array [object {1}]

required

url

string

required

Modified at 2023-07-27 02:58:35

README

Create image edit