GPT Image 1 - Image Text Editor

Transform and enhance your images using natural language descriptions with OpenAI's GPT Image 1 model. This advanced text-based image editor allows you to modify existing images by describing the changes you want to see, from subtle style adjustments to dramatic transformations. Built on OpenAI's most sophisticated vision model, GPT Image 1 delivers exceptional quality with superior understanding of complex editing instructions.

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-1`
`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 be edited	-
`prompt`	string	Yes	Text description of the desired image transformation (max 4000 characters)	-
`size`	string	Yes	Output image dimensions	`1024x1024`
`n`	number	Yes	Number of images to generate (1-10)	1
`quality`	string	No	Quality level of the generated image	`medium`
`output_format`	string	No	Output format for the processed image	`png`
`output_compression`	number	No	Compression level for output (0-100, higher = better quality)	85
`background`	string	No	Background handling for edited areas	`auto`

Size Options

Size	Description
`1024x1024`	Square format (1:1)
`1024x1536`	Portrait format (2:3)
`1536x1024`	Landscape format (3:2)

Quality Options

Quality	Description	Use Case
`low`	Faster processing, reduced detail	Quick iterations, drafts, previews
`medium`	Balanced quality and speed	General editing, standard workflows
`high`	Maximum detail and refinement	Professional work, final outputs, detailed edits

Output Format Options

Format	Description	Best For
`png`	Lossless format with transparency support	Professional use, detailed editing, archival quality
`jpeg`	Compressed format suitable for photographs	Web optimization, social media, smaller file sizes
`webp`	Modern format with superior compression	Web applications, modern browsers

Background Options

Background	Description
`auto`	AI automatically determines optimal background handling
`preserve`	Keep original background unchanged where possible
`transparent`	Generate transparent background in edited areas (PNG only)
`white`	Use white background for edited areas
`black`	Use black background for edited areas

Code Examples

cURL
JavaScript
Python

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-1",
  "promptObject": {
    "imageUrl": "development/images/2025_12_04_18_10_29_882_cat.png",
    "prompt": "transform into a watercolor painting style with soft brushstrokes and vibrant colors, maintaining the original composition",
    "size": "1024x1024",
    "n": 1,
    "quality": "high",
    "output_format": "png",
    
    "background": "auto"
  }
}'

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-1',
  promptObject: {
    imageUrl: 'development/images/2025_12_04_18_10_29_882_cat.png',
    prompt: 'transform into a watercolor painting style with soft brushstrokes and vibrant colors, maintaining the original composition',
    size: '1024x1024',
    n: 1,
    quality: 'high',
    output_format: 'png',
          background: 'auto'
  }
})
})
.then(response => response.json())
.then(data => console.log(data));

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-1",
"promptObject": {
  "imageUrl": "development/images/2025_12_04_18_10_29_882_cat.png",
  "prompt": "transform into a watercolor painting style with soft brushstrokes and vibrant colors, maintaining the original composition",
  "size": "1024x1024",
  "n": 1,
  "quality": "high",
  "output_format": "png",
  
  "background": "auto"
}
}

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

Interactive Playground

API Playground

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

AI Model *

Source Image URL *

Path to the source image to be edited

Edit Prompt *

Describe how you want to transform the image (max 4000 characters)

Image Size *

Dimensions of the output image

Number of Images *

Number of edited images to generate (1-10)

Quality Level

Quality level affects detail, processing time, and credit cost

Output Format

Format of the output image

Output Compression

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

Background Handling

How to handle background in edited areas

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-1",
  "promptObject": {
    "imageUrl": "development/images/2025_12_04_18_10_29_882_cat.png",
    "prompt": "transform into a watercolor painting style with soft brushstrokes and vibrant colors, maintaining the original composition",
    "size": "1024x1024",
    "n": 1,
    "quality": "high",
    "output_format": "png",
    "background": "auto"
  }
}'

Response Format

{
"aiRecord": {
  "uuid": "i1m2e3d4-v5e6-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": 250000,
    "createdAt": "2025-01-01T00:00:00.000Z",
    "createdBy": "SYSTEM",
    "updatedAt": "2025-01-15T16:00:00.000Z",
    "updatedBy": "SYSTEM"
  },
  "model": "gpt-image-1",
  "type": "IMAGE_EDITOR",
  "metadata": null,
  "rating": null,
  "feedback": null,
  "conversationId": null,
  "status": "SUCCESS",
  "createdAt": "2025-01-15T16:00:00.000Z",
  "aiRecordDetail": {
    "promptObject": {
      "imageUrl": "development/images/2025_12_04_18_10_29_882_cat.png",
      "prompt": "transform into a watercolor painting style with soft brushstrokes and vibrant colors, maintaining the original composition",
      "size": "1024x1024",
      "n": 1,
      "quality": "high",
      "output_format": "png",
      
      "background": "auto"
    },
    "resultObject": [
      "development/images/2025_01_15_16_00_30_001_edited.png"
    ],
    "responseObject": {}
  },
  "additionalData": null,
  "temporaryUrl": "https://s3.us-east-1.amazonaws.com/asset.1min.ai/development/images/2025_01_15_16_00_30_001_edited.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=EXAMPLE_CREDENTIAL&X-Amz-Date=20250115T160000Z&X-Amz-Expires=604800&X-Amz-Signature=example_signature&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject"
}
}

Use Cases

Creative Photo Editing & Enhancement

Artistic Transformations: Convert photographs into paintings, sketches, or digital art styles
Style Transfer: Apply specific artistic styles while maintaining the original composition
Mood Adjustments: Change lighting, atmosphere, and emotional tone of images
Color Grading: Professional color correction and creative color manipulation
Texture Modifications: Add or enhance textures like watercolor, oil paint, or pencil drawings

Professional Photography

Portrait Enhancement: Refine lighting, skin tones, and overall aesthetic quality
Background Modifications: Change or enhance backgrounds while preserving subjects
Lighting Adjustments: Modify time of day, lighting direction, or intensity
Seasonal Variations: Transform images to different seasons or weather conditions
Professional Refinement: Polish images with subtle enhancements for client deliverables

E-commerce & Product Photography

Product Styling: Modify product appearances, colors, or finishes
Environment Changes: Place products in different settings or contexts
Lifestyle Integration: Transform product shots into lifestyle imagery
Seasonal Adaptations: Update product photography for different seasons or campaigns
Brand Consistency: Ensure visual consistency across product catalogs

Marketing & Advertising

Campaign Customization: Adapt creative assets for different markets or demographics
A/B Testing: Generate variations of marketing images for performance testing
Localization: Customize imagery for regional or cultural contexts
Trend Adaptation: Update visuals to match current design trends
Social Media Optimization: Create platform-specific variations of marketing materials

Interior & Architectural Design

Design Visualization: Show different design concepts using the same base space
Style Exploration: Experiment with various interior design styles
Color Scheme Testing: Visualize different color palettes and material choices
Lighting Scenarios: Show spaces under different lighting conditions
Client Presentations: Present multiple design options efficiently

Content Variations: Create multiple versions for different social platforms
Aesthetic Consistency: Maintain cohesive visual branding across posts
Engagement Optimization: Enhance images to increase visual appeal and engagement
Story Enhancement: Add creative effects that support narrative content
Trend Participation: Quickly adapt images to participate in visual trends

Endpoint​

Request Headers​

Parameters​

Prompt Object Parameters​

Size Options​

Quality Options​

Output Format Options​

Background Options​

Code Examples​

Interactive Playground​

API Playground

Generated cURL Command:

Response Format​

Use Cases​

Creative Photo Editing & Enhancement​

Professional Photography​

E-commerce & Product Photography​

Marketing & Advertising​

Interior & Architectural Design​

Social Media & Content Creation​