OpenAIMediumUltra

GPT Image 1.5

OpenAI's latest image generation model with better instruction following and adherence to prompts, including sharp text rendering and detailed editing.

310 credits

per image at high/auto quality; 31 at low, 120 at medium

Four quality tiers (low/medium/high/auto) with proportional pricing

Strong instruction following and prompt adherence

Sharp in-image text rendering

Image editing via input_images with adjustable input_fidelity

Transparent or opaque background control

Run it right now

Test this model instantly in the Console Playground — no code required

Use with AI Assistant

Copy usage instructions for Claude, ChatGPT, or other AI

llms.txtllms.txt ↗

Quick Start

curl -X POST "https://api.core.today/v1/predictions" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cdt_your_api_key" \
  -d '{
  "model": "openai/gpt-image-1.5",
  "input": {
    "prompt": "make a scene in chelsea, london in the 1970s, photorealistic, everything in focus, with tons of people, and a bus with an advertisement for \"ImageGen 1.5 on Replicate\"",
    "quality": "high",
    "aspect_ratio": "1:1"
  }
}'

Parameters

Parameter	Type	Required	Default	Description
`prompt`	string	Yes	-	A text description of the desired image
`openai_api_key`	string	No	-	Your OpenAI API key (optional - uses proxy if not provided)
`aspect_ratio`	string	No	1:1	The aspect ratio of the generated image 1:13:22:3
`input_fidelity`	string	No	low	How much effort the model exerts to match style and facial features of input images lowhigh
`input_images`	array	No	-	A list of images to use as input for editing or composing
`number_of_images`	integer	No	1	Number of images to generate. Restricted to 1 in this gateway for accurate per-image billing
`quality`	string	No	auto	The quality of the generated image. Determines the credit tier (low/medium/high/auto) lowmediumhighauto
`background`	string	No	auto	Set whether the background is transparent, opaque, or chosen automatically autotransparentopaque
`output_compression`	integer	No	90	Compression level (0-100%)
`output_format`	string	No	webp	Output image format pngjpegwebp
`moderation`	string	No	auto	Content moderation level autolow
`user_id`	string	No	-	An optional unique identifier representing your end-user. This helps OpenAI monitor and detect abuse.

How to Provide File Input

There are 3 ways to provide files for the input_images parameter:

Recommended

Direct Upload (Multipart)

Attach files directly to POST /v1/predictions/upload. No separate upload step needed.

curl -X POST "https://api.core.today/v1/predictions/upload" \
  -H "X-API-Key: cdt_your_api_key" \
  -F "model=openai/gpt-image-1.5" \
  -F 'input={"prompt":"your prompt here"}' \
  -F "file:input_images=@your_file.png"

Image URL

Pass a publicly accessible URL directly. You can also use file_url from the Storage API.

{
  "model": "openai/gpt-image-1.5",
  "input": {
    "prompt": "your prompt here",
    "input_images": ["https://example.com/image.jpg"]
  }
}

See the File Upload docs for more upload methods including Presigned URLs.

Common Parameters

Common parameters used when calling POST /v1/predictions.

Parameter	Type	Required	Default	Description
`model`	string	Yes	-	Model identifier
`input`	object	Yes	-	Object containing the model-specific parameters from the table above
`output_folder`	string	No	-	Folder path for output files (max 256 chars, '..' not allowed)
`webhook_url`	string	No	-	Webhook URL to call on completion
`is_public`	boolean	No	false	If true, output files are also available via permanent public URLs

Examples

High-Quality Photorealistic Scene (Default)

A detailed photorealistic scene at high quality

curl -X POST "https://api.core.today/v1/predictions" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cdt_your_api_key" \
  -d '{
  "model": "openai/gpt-image-1.5",
  "input": {
    "prompt": "make a scene in chelsea, london in the 1970s, photorealistic, everything in focus, with tons of people, and a bus with an advertisement for \"ImageGen 1.5 on Replicate\"",
    "quality": "high",
    "aspect_ratio": "1:1"
  }
}'

Low-Cost Draft

Fast, cheap iteration using the low quality tier

curl -X POST "https://api.core.today/v1/predictions" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cdt_your_api_key" \
  -d '{
  "model": "openai/gpt-image-1.5",
  "input": {
    "prompt": "a minimalist logo concept for a coffee brand, flat design",
    "quality": "low"
  }
}'