Skip to main content

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

FieldValue
API-KEY<api-key>
Content-Typeapplication/json

Parameters

ParameterTypeRequiredDescription
typestringYesFeature type identifier. Must be IMAGE_OBJECT_REMOVER
modelstringYesAI model identifier. Must be stable-image
promptObjectobjectYesConfiguration object containing all object removal parameters

Prompt Object Parameters

ParameterTypeRequiredDescriptionDefault
imageUrlstringYesPath to the source image containing objects to remove-
maskUrlstringYesPath to the mask image defining areas to remove (white=remove, black=keep)-
output_formatstringNoOutput format for the processed imagepng

Supported Output Formats

FormatDescriptionBest For
pngHigh quality lossless format with transparency supportProfessional use, detailed images, archival quality
jpegCompressed format suitable for photographsWeb optimization, social media, smaller file sizes
webpModern format with superior compressionWeb applications, modern browsers

Mask Image Requirements

RequirementDescription
FormatPNG, JPEG, or WebP formats supported
DimensionsMust match the source image dimensions exactly
Color SchemeWhite areas = objects to remove, Black areas = areas to preserve
Grayscale SupportGray values for partial transparency/blending effects

Code Examples

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"
}
}'

Interactive Playground

API Playground

https://api.1min.ai/api/features
Path 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

  1. 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
  2. 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
  3. 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
  4. 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
  5. 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
  6. 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

  • 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