GPT Image 2 - Image Text Editor

Edit and transform images using natural language descriptions with OpenAI's GPT Image 2 model. This premium image editing solution provides the highest creative fidelity with fully custom output dimensions, allowing you to modify, enhance, or completely reimagine any image while retaining full control over the output size.

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_EDITOR
model	string	Yes	AI model identifier. Must be gpt-image-2
promptObject	object	Yes	Configuration object containing all image editing parameters

Prompt Object Parameters

Parameter	Type	Required	Description	Default
imageUrl	string	Yes	Path to the source image to edit	-
prompt	string	Yes	Description of the desired edits or transformations (max 4000 characters)	-
size	string	Yes	Output image dimensions in WxH format (e.g. 1024x1024)	-
quality	string	Yes	Quality level of the edited output	-
n	number	No	Number of variations to generate (1-10)	1
background	string	No	Background transparency mode	auto
output_format	string	No	Output format for the processed 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 ✓, 3840×512 ✗

Quality Options

Quality	Description	Use Case
low	Faster processing, good quality	Quick previews, concept iterations
medium	Balanced quality and speed	Standard workflows, most projects
high	Maximum detail and fidelity	Professional work, final outputs

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 -X POST "https://api.1min.ai/api/features" \
-H "API-KEY: <api-key>" \
-H "Content-Type: application/json" \
-d '{
  "type": "IMAGE_EDITOR",
  "model": "gpt-image-2",
  "promptObject": {
    "imageUrl": "development/images/2025_12_04_18_03_51_184_landscape.png",
    "prompt": "Change the sky to a dramatic sunset with vivid orange and purple tones",
    "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_EDITOR',
  model: 'gpt-image-2',
  promptObject: {
    imageUrl: 'development/images/2025_12_04_18_03_51_184_landscape.png',
    prompt: 'Change the sky to a dramatic sunset with vivid orange and purple tones',
    size: '1536x1024',
    quality: 'high',
    n: 1,
    background: 'auto',
    output_format: 'png'
  }
})
})
.then(response => response.json())
.then(data => console.log(data));

Python

import requests

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

data = {
"type": "IMAGE_EDITOR",
"model": "gpt-image-2",
"promptObject": {
  "imageUrl": "development/images/2025_12_04_18_03_51_184_landscape.png",
  "prompt": "Change the sky to a dramatic sunset with vivid orange and purple tones",
  "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

Source Image URL *

Path to the source image to edit

Edit Description *

Describe the desired edits or transformations (max 4000 characters)

Change the sky to a dramatic sunset with vivid orange and purple tones

Image Size *

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

Quality Level *

Quality level affects detail and credit cost

Low Quality (Fast)Medium Quality (Balanced)High Quality (Best)

Number of Variations

Number of variations to generate (1-10)

Background Mode

Background transparency mode

Auto (Model Selects)Opaque (Solid)

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_EDITOR",
  "model": "gpt-image-2",
  "promptObject": {
    "imageUrl": "development/images/2025_12_04_18_03_51_184_landscape.png",
    "prompt": "Change the sky to a dramatic sunset with vivid orange and purple tones",
    "size": "1024x1024",
    "quality": "medium",
    "n": 1,
    "background": "auto",
    "output_format": "png"
  }
}'

Response Format

{
"aiRecord": {
  "uuid": "c1d2e3f4-g5h6-7890-abcd-ef1234567890",
  "userId": "user-12345",
  "teamId": "team-67890",
  "teamUser": {
    "teamId": "team-67890",
    "userId": "user-12345",
    "userName": "Jane Designer",
    "userAvatar": "https://example.com/avatar.jpg",
    "status": "ACTIVE",
    "role": "ADMIN",
    "creditLimit": 100000000,
    "usedCredit": 180000,
    "createdAt": "2025-01-01T00:00:00.000Z",
    "createdBy": "SYSTEM",
    "updatedAt": "2025-01-15T11:00:00.000Z",
    "updatedBy": "SYSTEM"
  },
  "model": "gpt-image-2",
  "type": "IMAGE_EDITOR",
  "metadata": null,
  "rating": null,
  "feedback": null,
  "conversationId": null,
  "status": "SUCCESS",
  "createdAt": "2025-01-15T11:00:00.000Z",
  "aiRecordDetail": {
    "promptObject": {
      "imageUrl": "development/images/2025_12_04_18_03_51_184_landscape.png",
      "prompt": "Change the sky to a dramatic sunset with vivid orange and purple tones",
      "size": "1536x1024",
      "quality": "high",
      "n": 1,
      "background": "auto",
      "output_format": "png"
    },
    "resultObject": [
      "development/images/2025_01_15_11_00_45_001_landscape_edited.png"
    ],
    "responseObject": {}
  },
  "additionalData": null,
  "temporaryUrl": "https://s3.us-east-1.amazonaws.com/asset.1min.ai/development/images/2025_01_15_11_00_45_001_landscape_edited.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=EXAMPLE_CREDENTIAL&X-Amz-Date=20250115T110000Z&X-Amz-Expires=604800&X-Amz-Signature=example_signature&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject"
}
}

Use Cases

• Photo Retouching: Adjust lighting, color grading, and visual atmosphere
• Style Transfer: Transform an image's artistic style or aesthetic
• Object Modification: Change colors, textures, or appearance of specific elements
• Environmental Changes: Modify weather, time of day, or season
• Content Enhancement: Add, remove, or modify elements within images
• Creative Exploration: Generate multiple stylistic variations for creative projects
• Product Photography: Enhance product images for e-commerce or marketing