GPT Image 1 Mini - Image Mask Editor

Edit and transform specific areas of images using mask-based selection with OpenAI's GPT Image 1 Mini model. This cost-effective inpainting solution delivers excellent quality with faster processing speeds, perfect for high-volume editing workflows, rapid iterations, and budget-conscious projects. Precisely control which areas to modify with masks while maintaining professional results.

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_INPAINTER`
`model`	string	Yes	AI model identifier. Must be `gpt-image-1-mini`
`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	-
`maskUrl`	string	Yes	Path to the mask image (white=edit, black=preserve)	-
`prompt`	string	Yes	Description of content to generate in masked areas (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 content	`medium`
`output_format`	string	No	Output format for the processed image	`png`
`output_compression`	number	No	Compression level (0-100, higher = better quality)	85

Size Options

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

Quality Options

Quality	Description	Processing Speed	Use Case
`low`	Good quality, fastest processing	Very Fast	Quick iterations, concept testing
`medium`	Excellent quality, fast processing	Fast	Standard workflows, most projects
`high`	Premium quality, moderate speed	Moderate	Professional outputs, final deliverables

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

Mask Image Requirements

Requirement	Description
Format	PNG, JPEG, or WebP formats supported
Dimensions	Must match source image dimensions exactly
Color Scheme	White (#FFFFFF) = edit areas, Black (#000000) = preserve areas
Grayscale Support	Gray values for partial blending and soft transitions
Edge Quality	Clean, well-defined boundaries for best results

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_INPAINTER",
  "model": "gpt-image-1-mini",
  "promptObject": {
    "imageUrl": "development/images/2025_12_04_18_10_29_882_cat.png",
    "maskUrl": "development/images/2025_12_04_18_11_04_824_image.png",
    "prompt": "modern pendant light with brushed metal finish, LED bulbs, contemporary design",
    "size": "1024x1024",
    "n": 1,
    "quality": "medium",
    "output_format": "png",
  }
}'

fetch('https://api.1min.ai/api/features', {
method: 'POST',
headers: {
  'Content-Type': 'application/json',
  'API-KEY': 'YOUR_API_KEY'
},
body: JSON.stringify({
  type: 'IMAGE_INPAINTER',
  model: 'gpt-image-1-mini',
  promptObject: {
    imageUrl: 'development/images/2025_12_04_18_10_29_882_cat.png',
    maskUrl: 'development/images/2025_12_04_18_11_04_824_image.png',
    prompt: 'modern pendant light with brushed metal finish, LED bulbs, contemporary design',
    size: '1024x1024',
    n: 1,
    quality: 'medium',
    output_format: 'png',
  }
})
})
.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_INPAINTER",
"model": "gpt-image-1-mini",
"promptObject": {
  "imageUrl": "development/images/2025_12_04_18_10_29_882_cat.png",
  "maskUrl": "development/images/2025_12_04_18_11_04_824_image.png",
  "prompt": "modern pendant light with brushed metal finish, LED bulbs, contemporary design",
  "size": "1024x1024",
  "n": 1,
  "quality": "medium",
  "output_format": "png",
}
}

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

Mask Image URL *

Path to mask (white areas will be edited, black areas preserved)

Content Prompt *

Describe what to generate in masked areas (max 4000 characters)

Image Size *

Dimensions of the output image

Number of Images *

Number of edited images to generate (1-10)

Quality Level

Quality affects detail, blending, and credit cost

Output Format

Format of the output image

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_INPAINTER",
  "model": "gpt-image-1-mini",
  "promptObject": {
    "imageUrl": "development/images/2025_12_04_18_10_29_882_cat.png",
    "maskUrl": "development/images/2025_12_04_18_11_04_824_image.png",
    "prompt": "modern pendant light with brushed metal finish, LED bulbs, contemporary design",
    "size": "1024x1024",
    "n": 1,
    "quality": "medium",
    "output_format": "png"
  }
}'

Response Format

{
"aiRecord": {
  "uuid": "i1m2p3a4-v5e6-7890-abcd-ef1234567890",
  "userId": "user-12345",
  "teamId": "team-67890",
  "teamUser": {
    "teamId": "team-67890",
    "userId": "user-12345",
    "userName": "Alex Designer",
    "userAvatar": "https://example.com/avatar.jpg",
    "status": "ACTIVE",
    "role": "ADMIN",
    "creditLimit": 100000000,
    "usedCredit": 28000,
    "createdAt": "2025-01-01T00:00:00.000Z",
    "createdBy": "SYSTEM",
    "updatedAt": "2025-01-15T16:00:00.000Z",
    "updatedBy": "SYSTEM"
  },
  "model": "gpt-image-1-mini",
  "type": "IMAGE_INPAINTER",
  "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",
      "maskUrl": "development/images/2025_12_04_18_11_04_824_image.png",
      "prompt": "modern pendant light with brushed metal finish, LED bulbs, contemporary design",
      "size": "1024x1024",
      "n": 1,
      "quality": "medium",
      "output_format": "png",
    },
    "resultObject": [
      "development/images/2025_01_15_16_00_30_001_inpainted.png"
    ],
    "responseObject": {}
  },
  "additionalData": null,
  "temporaryUrl": "https://s3.us-east-1.amazonaws.com/asset.1min.ai/development/images/2025_01_15_16_00_30_001_inpainted.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

High-Volume Photo Editing

Batch Product Editing: Process large catalogs efficiently
E-commerce Optimization: Quick product photo enhancements at scale
Social Media Content: Rapid content creation for multiple platforms
Marketing Materials: Generate variations for A/B testing
Real Estate Photos: Edit multiple property images quickly

Rapid Iteration & Testing

Design Exploration: Test multiple concepts quickly
Client Previews: Generate preview variations efficiently
Creative Testing: Experiment with different approaches
Concept Validation: Quick validation before final production
Workflow Development: Test editing workflows

Cost-Effective Projects

Startup Workflows: Professional results within budget
Content Marketing: Regular content creation at lower costs
Educational Projects: Learning and skill development
Personal Projects: Portfolio and personal work
Prototyping: Test concepts before scaling

Professional Applications

Interior Design: Visualize furniture and décor changes
Product Photography: Remove imperfections or add variations
Architectural Visualization: Show different material options
Event Photography: Quick touch-ups and enhancements
Portrait Retouching: Professional-grade edits efficiently

Mask Creation Tools

Recommended Tools for Professional Masks

Adobe Photoshop: Industry-standard with advanced selection and masking tools
GIMP: Free alternative with comprehensive masking capabilities
Canva: User-friendly online tool for basic mask creation
Paint.NET: Windows-based tool with good selection features
Procreate: iPad app excellent for precise digital masking

Mask Quality Checklist

✅ Exact Dimensions: Mask matches source image size perfectly
✅ High Contrast: Clear distinction between edit areas (white) and preserve areas (black)
✅ Clean Boundaries: Smooth, well-defined edges around objects
✅ Appropriate Coverage: All target areas properly marked for editing
✅ Edge Quality: Suitable edge treatment (hard or soft) for the editing type

Endpoint​

Request Headers​

Parameters​

Prompt Object Parameters​

Size Options​

Quality Options​

Output Format Options​

Mask Image Requirements​

Code Examples​

Interactive Playground​