Create gpt-image-1

POST

/v1/images/generations

Given a hint, the model will return the completion of one or more predictions, and can also return the probability of the alternative label at each location.

Completed creation based on the provided prompts and parameters

Official documentation: https://platform.openai.com/docs/api-reference/images/create

Request

Header Params

Body Params application/json

Example

{
"size": "1024x1536",
"prompt": "A cute little pig",
"model": "gpt-image-1",
"n": 1
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/v1/images/generations' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data '{
"size": "1024x1536",
"prompt": "A cute little pig",
"model": "gpt-image-1",
"n": 1
}'

Responses

🟢200OK

application/json

Bodyapplication/json

Example

{
"id": "chatcmpl-123",
"object": "chat.completion",
"created": 1677652288,
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "\n\nHello there, how may I assist you today?"
},
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 9,
"completion_tokens": 12,
"total_tokens": 21
}
}

Modified at 2026-09-23 08:28:57

Describe

Edit gpt-image-1