OpenAI image generation

POST

/v1/images/generations

OpenAI

Generates one or more images from a text prompt using OpenAI image models.

Supported Models

gpt-image-2

gpt-image-2-vip

Notes

background, output_format, output_compression, and moderation apply only to gpt-image-* models.

output_compression is only meaningful when output_format is jpeg or webp.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Body Params application/jsonRequired

Example

{
    "model": "gpt-image-2",
    "prompt": "string",
    "n": 1,
    "size": "256x256",
    "quality": "low",
    "response_format": "url",
    "style": "vivid",
    "background": "transparent",
    "output_format": "png",
    "output_compression": 0,
    "moderation": "low",
    "user": "string"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/v1/images/generations' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "model": "gpt-image-2",
    "prompt": "string",
    "n": 1,
    "size": "256x256",
    "quality": "low",
    "response_format": "url",
    "style": "vivid",
    "background": "transparent",
    "output_format": "png",
    "output_compression": 0,
    "moderation": "low",
    "user": "string"
}'

Responses

🟢200

application/json

Successful response

Bodyapplication/json

Example

{
    "created": 0,
    "data": [
        {
            "url": "string",
            "b64_json": "string",
            "revised_prompt": "string"
        }
    ]
}

🟠400

🟠401

🟠429

🔴500

Modified at 2026-07-29 01:22:52

Chat completion (all text models)

OpenAI image edit