GPT Image 2 - Background Replacer

Replace and transform image backgrounds using natural language descriptions with OpenAI's GPT Image 2 model. This premium background replacement solution delivers the highest creative fidelity with fully custom output dimensions, allowing you to specify any resolution that meets the model's size constraints.

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

Prompt Object Parameters

Parameter	Type	Required	Description	Default
imageUrl	string	Yes	Path to the source image for background replacement	-
prompt	string	Yes	Description of desired background scene (max 4000 characters)	-
size	string	Yes	Output image dimensions in WxH format (e.g. 1024x1024)	-
quality	string	Yes	Quality level of the generated background	-
background	string	No	Background transparency mode	auto

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, iterations
medium	Balanced quality and speed	Standard workflows, most projects
high	Maximum detail and realism	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

Code Examples

cURL

curl -X POST "https://api.1min.ai/api/features" \
-H "API-KEY: <api-key>" \
-H "Content-Type: application/json" \
-d '{
  "type": "BACKGROUND_REPLACER",
  "model": "gpt-image-2",
  "promptObject": {
    "imageUrl": "development/images/2025_12_04_18_03_51_184_cat.png",
    "prompt": "professional studio background with soft gray gradient, subtle lighting from top-left, minimalist and clean aesthetic",
    "size": "1024x1024",
    "quality": "high",
    "background": "auto"
  }
}'

JavaScript

fetch('https://api.1min.ai/api/features', {
method: 'POST',
headers: {
  'Content-Type': 'application/json',
  'API-KEY': 'YOUR_API_KEY'
},
body: JSON.stringify({
  type: 'BACKGROUND_REPLACER',
  model: 'gpt-image-2',
  promptObject: {
    imageUrl: 'development/images/2025_12_04_18_03_51_184_cat.png',
    prompt: 'professional studio background with soft gray gradient, subtle lighting from top-left, minimalist and clean aesthetic',
    size: '1024x1024',
    quality: 'high',
    background: 'auto'
  }
})
})
.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": "BACKGROUND_REPLACER",
"model": "gpt-image-2",
"promptObject": {
  "imageUrl": "development/images/2025_12_04_18_03_51_184_cat.png",
  "prompt": "professional studio background with soft gray gradient, subtle lighting from top-left, minimalist and clean aesthetic",
  "size": "1024x1024",
  "quality": "high",
  "background": "auto"
}
}

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 for background replacement

Background Description *

Describe the new background you want (max 4000 characters)

professional studio background with soft gray gradient, subtle lighting from top-left, minimalist and clean aesthetic

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)

Background Mode

Background transparency mode

Auto (Model Selects)Opaque (Solid)

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": "BACKGROUND_REPLACER",
  "model": "gpt-image-2",
  "promptObject": {
    "imageUrl": "development/images/2025_12_04_18_03_51_184_cat.png",
    "prompt": "professional studio background with soft gray gradient, subtle lighting from top-left, minimalist and clean aesthetic",
    "size": "1024x1024",
    "quality": "high",
    "background": "auto"
  }
}'

Response Format

{
"aiRecord": {
  "uuid": "b1g2r3m4-v5e6-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": 250000,
    "createdAt": "2025-01-01T00:00:00.000Z",
    "createdBy": "SYSTEM",
    "updatedAt": "2025-01-15T14:00:00.000Z",
    "updatedBy": "SYSTEM"
  },
  "model": "gpt-image-2",
  "type": "BACKGROUND_REPLACER",
  "metadata": null,
  "rating": null,
  "feedback": null,
  "conversationId": null,
  "status": "SUCCESS",
  "createdAt": "2025-01-15T14:00:00.000Z",
  "aiRecordDetail": {
    "promptObject": {
      "imageUrl": "development/images/2025_12_04_18_03_51_184_cat.png",
      "prompt": "professional studio background with soft gray gradient, subtle lighting from top-left, minimalist and clean aesthetic",
      "size": "1024x1024",
      "quality": "high",
      "background": "auto"
    },
    "resultObject": [
      "development/images/2025_01_15_14_00_30_001_background_replaced.png"
    ],
    "responseObject": {}
  },
  "additionalData": null,
  "temporaryUrl": "https://s3.us-east-1.amazonaws.com/asset.1min.ai/development/images/2025_01_15_14_00_30_001_background_replaced.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=EXAMPLE_CREDENTIAL&X-Amz-Date=20250115T140000Z&X-Amz-Expires=604800&X-Amz-Signature=example_signature&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject"
}
}

Use Cases

Professional Photography & Portraits

• Studio Backgrounds: Create professional studio settings with gradient or solid color backgrounds
• Environmental Portraits: Place subjects in specific locations or environments
• Headshot Enhancement: Transform casual photos into professional headshots
• Virtual Backgrounds: Create custom backgrounds for video conferencing assets

E-commerce & Product Photography

• Product Isolation: Replace cluttered backgrounds with clean, professional settings
• Lifestyle Contexts: Place products in realistic usage environments
• Brand Consistency: Apply branded backgrounds across product catalogs
• Seasonal Themes: Update product photos with seasonal or holiday backgrounds

Marketing & Advertising

• Campaign Customization: Adapt imagery for different markets with location-appropriate backgrounds
• Brand Integration: Replace backgrounds with branded environments
• Mood Creation: Set specific atmospheres that align with campaign messaging
• Social Media: Create platform-optimized backgrounds for different channels

Creative & Artistic Projects

• Fantasy Scenes: Place subjects in imaginative or impossible environments
• Artistic Styles: Generate artistic or stylized backgrounds
• Conceptual Photography: Create conceptual images with specific thematic backgrounds
• Story Telling: Create narrative contexts through background replacement