Generate Image by gpt-image-1

POST

/v1/images/generations

Request

Header Params

Authorization

string

optional

Example:

Bearer {{YOUR_API_KEY}}

Body Params application/json

prompt

string

required

The textual instruction that describes what image we want the model to generate.

model

string

required

Use gpt-image-1

integer

optional

The number of images to generate. Must be a number from 1 to 10.

size

string

optional

The size of the image in pixels. It must be one of "1024x1024" (square), "1536x1024" (landscape), "1024x1536" (portrait).

background

string

optional

The type of background for the image. It must be one of "transparent", "opaque", or "auto". The default value is "auto", in which the model will decide based on the content what the best background type is. Note that JPEG images don't support transparent backgrounds.

quality

string

optional

The quality of the generated image. It must be one of "high", "medium", or "low", with the default being "high".

moderation

string

optional

The level of content moderation. Must be either "low" for a less restrictive filter or "auto", which is the default.
We covered the most important paramet

Example

{
  "model": "gpt-image-1",
  "prompt": "A diverse group of Vietnamese teenagers (middle/high school age) standing together outdoors on a sunny summer day (perhaps near a modern school building or park), holding laptops/tablets. They are smiling, looking confidently towards the viewer or slightly upwards towards the future. Sense of camaraderie, achievement, and readiness for the digital world. Bright, cheerful, optimistic vibe. Natural lighting, vibrant colors. Photorealistic. --ar 16:9"
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/v1/images/generations' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data-raw '{
  "model": "gpt-image-1",
  "prompt": "A diverse group of Vietnamese teenagers (middle/high school age) standing together outdoors on a sunny summer day (perhaps near a modern school building or park), holding laptops/tablets. They are smiling, looking confidently towards the viewer or slightly upwards towards the future. Sense of camaraderie, achievement, and readiness for the digital world. Bright, cheerful, optimistic vibe. Natural lighting, vibrant colors. Photorealistic. --ar 16:9"
}'

Responses

🟢200Create image

application/json

Body

created

integer

required

data

array [object {2}]

required

b64_json

string

optional

url

string

required

usage

object

required

input_tokens

integer

required

input_tokens_details

object

required

output_tokens

integer

required

total_tokens

integer

required

Example

{
    "created": 1748231162,
    "data": [
        {
            "b64_json": "xxxxx"
        }
    ],
    "usage": {
        "input_tokens": 95,
        "input_tokens_details": {
            "image_tokens": 0,
            "text_tokens": 95
        },
        "output_tokens": 4160,
        "total_tokens": 4255
    }
}

Modified at 2025-05-26 03:50:47

Function calling - codeExecution

Edit Image by gpt-image-1