GPT Image 2 - Image Generator

Generate premium quality images from text prompts using OpenAI's latest GPT Image 2 model. Features fully flexible custom dimensions, superior creative fidelity, and token-based credit billing that scales precisely with image complexity and quality.

Endpoint

POSThttps://api.1min.ai/api/features

Request Headers

Field	Value
API-KEY	<api-key>
Content-Type	application/json

Parameters

Parameter	Type	Required	Description
type	string	Yes	Feature type identifier. Must be IMAGE_GENERATOR
model	string	Yes	AI model identifier. Must be gpt-image-2
promptObject	object	Yes	Configuration object containing all generation parameters

Prompt Object Parameters

Parameter	Type	Required	Description	Default
prompt	string	Yes	Text description of the image to generate (max 4000 characters)	-
size	string	Yes	Output image dimensions in WxH format (e.g. 1024x1024)	-
quality	string	Yes	Image quality level	-
n	number	No	Number of images to generate (1-10)	1
background	string	No	Background mode for the generated image	auto
output_format	string	No	Output format for the generated image	-
output_compression	number	No	Compression level (0-100, higher = better quality). Only applies when output_format is jpeg or webp	-

Size Constraints

GPT Image 2 accepts any custom dimension in WxH format (e.g. 1024x1024, 1280x720) subject to the following rules:

Constraint	Rule	Example
Block size	Width and height must both be divisible by 16	1024x1024 ✓, 1000x1000 ✗
Minimum pixels	Width × Height ≥ 655,360	1024×640 = 655,360 ✓
Maximum pixels	Width × Height ≤ 8,294,400	2880×2880 = 8,294,400 ✓
Maximum edge	Max(width, height) ≤ 3,840 px	3840×864 ✓, 4096×1024 ✗
Aspect ratio	Max edge / Min edge ≤ 3:1	3072×1024 ✓, 4096×256 ✗

Quality Options

Quality	Description	Use Case
low	Fast, cost-effective generation	Quick prototypes, iterations
medium	Balanced quality and speed	Most use cases, professional work
high	Premium quality with maximum detail	Final artwork, premium content

Background Options

Background	Description	Use Case
auto	Model selects the best background mode	General purpose, recommended default
opaque	Solid background	Standard images, no transparency needed

Output Format Options

Format	Description	Best For
png	Lossless format with transparency support	Professional use, highest quality
jpeg	Compressed format	Web optimization, smaller files
webp	Modern format with superior compression	Web applications

Code Examples

cURL

curl --location 'https://api.1min.ai/api/features' \
--header 'API-KEY: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
"type": "IMAGE_GENERATOR",
"model": "gpt-image-2",
"promptObject": {
  "prompt": "A serene Japanese garden with cherry blossoms and a traditional tea house",
  "size": "1536x1024",
  "quality": "high",
  "n": 1,
  "background": "auto",
  "output_format": "png"
}
}'

JavaScript

fetch('https://api.1min.ai/api/features', {
method: 'POST',
headers: {
  'Content-Type': 'application/json',
  'API-KEY': 'YOUR_API_KEY'
},
body: JSON.stringify({
  type: 'IMAGE_GENERATOR',
  model: 'gpt-image-2',
  promptObject: {
    prompt: 'A serene Japanese garden with cherry blossoms and a traditional tea house',
    size: '1536x1024',
    quality: 'high',
    n: 1,
    background: 'auto',
    output_format: 'png'
  }
})
})

Python

import requests

url = "https://api.1min.ai/api/features"
headers = {
"Content-Type": "application/json",
"API-KEY": "YOUR_API_KEY"
}

data = {
"type": "IMAGE_GENERATOR",
"model": "gpt-image-2",
"promptObject": {
  "prompt": "A serene Japanese garden with cherry blossoms and a traditional tea house",
  "size": "1536x1024",
  "quality": "high",
  "n": 1,
  "background": "auto",
  "output_format": "png"
}
}

response = requests.post(url, headers=headers, json=data)
print(response.json())

Interactive Playground

API Playground

GETPOSTPUTDELETEhttps://api.1min.ai/api/features

AI Model *GPT Image 2

Prompt *

Describe the image you want to generate in detail (max 4000 characters)

A serene Japanese garden with cherry blossoms and a traditional tea house

Image Size *

Custom dimensions in WxH format. Both values must be divisible by 16. E.g. 1024x1024, 1536x1024, 1024x1536

Quality *

Image quality level

Low (Fast & Cost-Effective)Medium (Balanced)High (Premium Quality)

Number of Images

Number of images to generate (1-10)

Background

Background mode for the generated image

Auto (Model Selects)Opaque (Solid Background)

Output Format

Format of the output image

PNG (Lossless)JPEG (Compressed)WebP (Modern)

Output Compression

Compression level (0-100, higher = better quality)

Generated cURL Command:

curl -X POST "https://api.1min.ai/api/features" \
  -H "API-KEY: <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{
  "type": "IMAGE_GENERATOR",
  "model": "gpt-image-2",
  "promptObject": {
    "prompt": "A serene Japanese garden with cherry blossoms and a traditional tea house",
    "size": "1024x1024",
    "quality": "medium",
    "n": 1,
    "background": "auto",
    "output_format": "png"
  }
}'

Response Format

{
"aiRecord": {
  "uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "userId": "user-12345",
  "teamId": "team-67890",
  "teamUser": {
    "teamId": "team-67890",
    "userId": "user-12345",
    "userName": "John Doe",
    "userAvatar": "https://example.com/avatar.jpg",
    "status": "ACTIVE",
    "role": "ADMIN",
    "creditLimit": 100000000,
    "usedCredit": 42000,
    "createdAt": "2025-01-01T00:00:00.000Z",
    "createdBy": "SYSTEM",
    "updatedAt": "2025-01-15T10:30:00.000Z",
    "updatedBy": "SYSTEM"
  },
  "model": "gpt-image-2",
  "type": "IMAGE_GENERATOR",
  "metadata": null,
  "rating": null,
  "feedback": null,
  "conversationId": null,
  "status": "SUCCESS",
  "createdAt": "2025-01-15T10:30:00.000Z",
  "aiRecordDetail": {
    "promptObject": {
      "prompt": "A serene Japanese garden with cherry blossoms and a traditional tea house",
      "size": "1536x1024",
      "quality": "high",
      "n": 1,
      "background": "auto",
      "output_format": "png"
    },
    "resultObject": [
      "development/images/2025_01_15_10_30_15_001_japanese_garden.png"
    ],
    "responseObject": {}
  },
  "additionalData": null,
  "temporaryUrl": "https://s3.us-east-1.amazonaws.com/asset.1min.ai/development/images/2025_01_15_10_30_15_001_japanese_garden.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=EXAMPLE_CREDENTIAL&X-Amz-Date=20250115T103000Z&X-Amz-Expires=604800&X-Amz-Signature=example_signature&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject"
}
}

Use Cases

• Creative Design: High-fidelity illustrations, concept art, and photo-realistic visuals at custom dimensions
• Social Media Content: Eye-catching posts, stories, and promotional materials tailored to exact platform sizes
• Marketing Assets: Product mockups, advertising visuals, and brand imagery at any resolution
• Character Design: Detailed character illustrations and visual storytelling
• Architecture Visualization: Hyper-realistic building designs and interior layouts
• Publishing: Premium book covers, editorial illustrations, and graphic design
• Game Assets: High-fidelity concept art and visual development for games