Stable Image Core - Object Remover
Remove unwanted objects from images using mask-based selection with Stability AI's advanced inpainting technology. Precisely control object removal by providing a mask image that defines which areas to remove, while the AI intelligently fills the masked regions with contextually appropriate content.
Endpoint
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_OBJECT_REMOVER |
model | string | Yes | AI model identifier. Must be stable-image |
promptObject | object | Yes | Configuration object containing all object removal parameters |
Prompt Object Parameters
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
imageUrl | string | Yes | Path to the source image containing objects to remove | - |
maskUrl | string | Yes | Path to the mask image defining areas to remove (white=remove, black=keep) | - |
output_format | string | No | Output format for the processed image | png |
Supported Output Formats
| Format | Description | Best For |
|---|---|---|
png | High quality lossless format with transparency support | Professional use, detailed images, 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 |
Mask Image Requirements
| Requirement | Description |
|---|---|
| Format | PNG, JPEG, or WebP formats supported |
| Dimensions | Must match the source image dimensions exactly |
| Color Scheme | White areas = objects to remove, Black areas = areas to preserve |
| Grayscale Support | Gray values for partial transparency/blending effects |
Code Examples
- cURL
- JavaScript
- Python
curl --location 'https://api.1min.ai/api/features' \
--header 'API-KEY: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
"type": "IMAGE_OBJECT_REMOVER",
"model": "stable-image",
"promptObject": {
"imageUrl": "development/images/2025_10_27_09_01_12_557_cat.png",
"maskUrl": "development/images/2025_10_27_09_01_51_306_image.png",
"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_OBJECT_REMOVER',
model: 'stable-image',
promptObject: {
imageUrl: 'development/images/2025_10_27_09_01_12_557_cat.png',
maskUrl: 'development/images/2025_10_27_09_01_51_306_image.png',
output_format: 'png'
}
})
})
import requests
url = "https://api.1min.ai/api/features"
headers = {
"Content-Type": "application/json",
"API-KEY": "YOUR_API_KEY"
}
data = {
"type": "IMAGE_OBJECT_REMOVER",
"model": "stable-image",
"promptObject": {
"imageUrl": "development/images/2025_10_27_09_01_12_557_cat.png",
"maskUrl": "development/images/2025_10_27_09_01_51_306_image.png",
"output_format": "png"
}
}
response = requests.post(url, headers=headers, json=data)
Interactive Playground
API Playground
https://api.1min.ai/api/featuresPath to the source image containing objects to remove
Path to the mask image (white areas will be removed)
Format of the output image with objects removed
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_OBJECT_REMOVER",
"model": "stable-image",
"promptObject": {
"imageUrl": "development/images/2025_10_27_09_01_12_557_cat.png",
"maskUrl": "development/images/2025_10_27_09_01_51_306_image.png",
"output_format": "png"
}
}'
Response Format
{
"aiRecord": {
"uuid": "o1b2j3r4-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": 30000,
"createdAt": "2025-01-01T00:00:00.000Z",
"createdBy": "SYSTEM",
"updatedAt": "2025-01-15T15:00:00.000Z",
"updatedBy": "SYSTEM"
},
"model": "stable-image",
"type": "IMAGE_OBJECT_REMOVER",
"metadata": null,
"rating": null,
"feedback": null,
"conversationId": null,
"status": "SUCCESS",
"createdAt": "2025-01-15T15:00:00.000Z",
"aiRecordDetail": {
"promptObject": {
"imageUrl": "development/images/2025_10_27_09_01_12_557_cat.png",
"maskUrl": "development/images/2025_10_27_09_01_51_306_image.png",
"output_format": "png"
},
"resultObject": [
"development/images/2025_01_15_15_00_30_001_object_removed.png"
],
"responseObject": {}
},
"additionalData": null,
"temporaryUrl": "https://s3.us-east-1.amazonaws.com/asset.1min.ai/development/images/2025_01_15_15_00_30_001_object_removed.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=EXAMPLE_CREDENTIAL&X-Amz-Date=20250115T150000Z&X-Amz-Expires=604800&X-Amz-Signature=example_signature&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject"
}
}
Use Cases
Photography & Image Restoration
- Tourist Photo Cleanup: Remove unwanted people, objects, or signs from travel photos
- Portrait Enhancement: Eliminate distracting background elements or objects
- Real Estate Photography: Remove temporary objects, furniture, or clutter from property images
- Event Photography: Clean up event photos by removing unwanted items or people
- Historical Photo Restoration: Remove artifacts, stains, or unwanted elements from old photographs
E-commerce & Product Photography
- Product Isolation: Remove competing products or distracting elements from product shots
- Catalog Preparation: Clean product images by removing price tags, labels, or promotional materials
- Inventory Photography: Standardize product photos by removing background objects
- Marketplace Listings: Create clean, professional product images for online sales
- Brand Consistency: Remove competitor branding or logos from reference images
Marketing & Advertising
- Campaign Assets: Remove unwanted elements from marketing photography
- Social Media Content: Clean up images for professional social media presence
- Website Graphics: Prepare hero images and banners by removing distracting objects
- Print Materials: Create clean images for brochures, catalogs, and promotional materials
- Brand Photography: Remove temporary or seasonal elements for timeless brand assets
Creative & Artistic Applications
- Digital Art Creation: Remove objects to create base images for artistic compositions
- Photo Manipulation: Prepare source images for complex composite projects
- Content Creation: Clean reference images for creative projects and campaigns
- Graphic Design: Remove unwanted elements to create design-ready images
- Stock Photography: Enhance stock images by removing dated or specific elements
Professional & Business Use
- Corporate Photography: Remove distracting elements from office or facility photos
- Documentation: Clean technical or instructional images by removing unnecessary objects
- Presentation Graphics: Prepare clean, professional images for business presentations
- Training Materials: Create clear instructional images by removing distracting elements
- Legal Documentation: Clean evidence photos while maintaining authenticity
Tips for Best Results
-
Mask Creation Guidelines: Create effective masks for optimal results
- High contrast: Use pure white (#FFFFFF) for areas to remove, pure black (#000000) for areas to keep
- Clean edges: Ensure mask edges are clean and well-defined for precise object removal
- Accurate boundaries: Trace object boundaries carefully to avoid removing desired elements
- Multiple objects: Use separate processing for complex scenes with multiple objects
-
Image Quality Considerations: Optimize source images for best results
- High resolution: Higher resolution images provide better inpainting quality
- Good lighting: Well-lit images help the AI understand context and textures
- Clear details: Sharp, detailed images produce more realistic inpainting results
- Stable exposure: Consistent lighting across the image improves blending
-
Mask Design Best Practices: Design masks for optimal object removal
- Precise selection: Include only the object to remove, avoid unnecessary areas
- Edge refinement: Use soft brushes for natural edges, hard brushes for defined objects
- Context preservation: Leave enough surrounding context for realistic inpainting
- Feathering: Use slight feathering on mask edges for seamless blending
-
Object Type Considerations: Different objects require different approaches
- Simple objects: Clean, geometric objects with defined edges work best
- Complex textures: Objects with intricate details may require careful mask creation
- Overlapping elements: Separate overlapping objects into multiple processing steps
- Background integration: Consider how removed objects integrate with background patterns
-
Format & Quality Optimization: Choose appropriate output settings
- PNG: Best for images requiring transparency or high-quality archival
- JPEG: Suitable for photographs and web use with smaller file sizes
- WebP: Modern format offering excellent compression for web applications
-
Advanced Techniques: Enhance results with advanced approaches
- Iterative processing: Process complex removals in multiple stages for better results
- Mask refinement: Adjust masks based on initial results for improved accuracy
- Context enhancement: Ensure sufficient background context around masked areas
- Quality validation: Review results and reprocess with adjusted parameters if needed
Mask Creation Tools
Recommended Tools for Mask Creation
- Adobe Photoshop: Professional mask creation with precise selection tools
- GIMP: Free alternative with comprehensive masking capabilities
- Canva: Simple online tool for basic mask creation
- Paint.NET: Windows-based tool with good selection and masking features
- Online Tools: Browser-based mask creation tools for quick editing
Mask Quality Checklist
- ✅ Exact dimensions: Mask matches source image dimensions perfectly
- ✅ High contrast: Clear white (remove) and black (keep) areas
- ✅ Clean edges: Smooth, well-defined boundaries around objects
- ✅ Complete coverage: All parts of target objects are marked for removal
- ✅ Context preservation: Sufficient background area left intact for inpainting
Notes
- Stable Image Core Object Remover uses advanced diffusion-based inpainting specifically optimized for object removal
- Results quality depends on mask accuracy, image complexity, and surrounding context availability
- The model excels at removing well-defined objects with clear boundaries and sufficient background context
- Processing times vary based on image resolution, mask complexity, and object size
- For best results, ensure masks are precisely created and source images have good resolution and lighting
- Multiple processing passes may be beneficial for complex scenes with overlapping or intricate objects
- The AI model intelligently analyzes surrounding context to generate realistic replacement content