Image generation API

GPT Image

OpenAI's GPT Image family — the most versatile image generation models, supporting text-to-image and image editing.

Provider: OpenAI19 models

Available models

Model key	Display name	Capability	Atlas Cloud slug
`gpt`	GPT Image 2	text-to-image	openai/gpt-image-2/text-to-image
`gpt_2`	GPT Image 2 (alias)	text-to-image	openai/gpt-image-2/text-to-image
`gpt5`	GPT Image 2 (high)	text-to-image	openai/gpt-image-2/text-to-image
`gpt_4o`	GPT Image 2 (4o)	text-to-image	openai/gpt-image-2/text-to-image
`gpt_mini`	GPT Image 2 Mini	text-to-image	openai/gpt-image-2/text-to-image
`gpt_3`	GPT Image 2 (v3)	text-to-image	openai/gpt-image-2/text-to-image
`gpt_1_hq`	GPT Image 1 HQ	text-to-image	openai/gpt-image-1/text-to-image
`gpt_1_5`	GPT Image 1.5	text-to-image	openai/gpt-image-1.5/text-to-image
`gpt_1_5_high`	GPT Image 1.5 High	text-to-image	openai/gpt-image-1.5/text-to-image
`gpt_image_2_t2i`	GPT Image 2 (explicit t2i)	text-to-image	openai/gpt-image-2/text-to-image
`gpt_image_2_edit`	GPT Image 2 Edit	edit	openai/gpt-image-2/edit
`gpt_image_2_dev_t2i`	GPT Image 2 Dev	text-to-image	openai/gpt-image-2-developer/text-to-image
`gpt_image_2_dev_edit`	GPT Image 2 Dev Edit	edit	openai/gpt-image-2-developer/edit
`gpt_image_1_5_t2i`	GPT Image 1.5 T2I	text-to-image	openai/gpt-image-1.5/text-to-image
`gpt_image_1_5_edit`	GPT Image 1.5 Edit	edit	openai/gpt-image-1.5/edit
`gpt_image_1_t2i`	GPT Image 1 T2I	text-to-image	openai/gpt-image-1/text-to-image
`gpt_image_1_edit`	GPT Image 1 Edit	edit	openai/gpt-image-1/edit
`gpt_image_1_mini_t2i`	GPT Image 1 Mini T2I	text-to-image	openai/gpt-image-1-mini/text-to-image
`gpt_image_1_mini_edit`	GPT Image 1 Mini Edit	edit	openai/gpt-image-1-mini/edit

Endpoint

POST /api/generate

Request body

Parameter	Type	Required	Description
`modelKey`	string	✓	One of the model keys listed above
`prompt`	string	✓	Text description of the image to generate
`inputUrl`	string		Input image URL (for edit/i2i models)
`aspectRatio`	string		`"1:1"`, `"16:9"`, `"9:16"`, etc.
`imageQuality`	string		`"Low"`, `"Medium"`, `"High"`
`styleRef`	string \| string[]		Style reference image URL(s)
`charRef`	string \| string[]		Character reference image URL(s)
`brandId`	string		Brand DNA ID for brand-consistent generation

Code example

curl -X POST https://api.oyefilmy.com/api/generate \
  -H "Authorization: Bearer of_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "modelKey": "gpt",
    "prompt": "A surreal painting of floating islands connected by glowing bridges in a twilight sky"
  }'

Response

{
  "success": true,
  "predictionId": "pred_abc123...",
  "status": "processing",
  "model": "openai/gpt-image-2/text-to-image",
  "creditCost": 5
}

GPT Image 2 is the recommended default for high-quality, versatile image generation. Use edit variants when providing an input image.

← All image models

Back to image generation overview

Webhooks

Receive results automatically