Recraft - Object Remover (Erase Region)
Remove unwanted objects or areas from images using Recraft's advanced AI technology. This tool allows you to precisely define regions to be erased using a mask, and the AI intelligently fills the space to match the surrounding 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 recraft |
promptObject | object | Yes | Configuration object containing parameters |
Prompt Object Parameters
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
imageUrl | string | Yes | Path to the source image | - |
maskUrl | string | Yes | Path to the mask image (white areas will be erased) | - |
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": "recraft",
"promptObject": {
"imageUrl": "images/2026_01_07_09_33_18_380_room.png",
"maskUrl": "images/2026_01_07_09_33_43_916_room_mask.png"
}
}'
const body = JSON.stringify({
type: 'IMAGE_OBJECT_REMOVER',
model: 'recraft',
promptObject: {
imageUrl: 'images/2026_01_07_09_33_18_380_room.png',
maskUrl: 'images/2026_01_07_09_33_43_916_room_mask.png'
}
});
fetch('https://api.1min.ai/api/features', {
method: 'POST',
headers: {
'API-KEY': 'YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: body
})
import requests
url = "https://api.1min.ai/api/features"
headers = {
"API-KEY": "YOUR_API_KEY",
"Content-Type": "application/json"
}
payload = {
"type": "IMAGE_OBJECT_REMOVER",
"model": "recraft",
"promptObject": {
"imageUrl": "images/2026_01_07_09_33_18_380_room.png",
"maskUrl": "images/2026_01_07_09_33_43_916_room_mask.png"
}
}
response = requests.post(url, headers=headers, json=payload)
Interactive Playground
API Playground
https://api.1min.ai/api/featuresPath to the source image
Path to the mask image (white areas will be erased)
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": "recraft",
"promptObject": {
"imageUrl": "images/2026_01_07_09_33_18_380_room.png",
"maskUrl": "images/2026_01_07_09_33_43_916_room_mask.png"
}
}'
Response Format
{
"aiRecord": {
"uuid": "r1e2c3r4-a5f6-7890-abcd-ef1234567891",
"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": 50000,
"createdAt": "2025-01-01T00:00:00.000Z",
"createdBy": "SYSTEM",
"updatedAt": "2026-01-02T13:13:31.000Z",
"updatedBy": "SYSTEM"
},
"model": "recraft",
"type": "IMAGE_OBJECT_REMOVER",
"metadata": null,
"rating": null,
"feedback": null,
"conversationId": null,
"status": "SUCCESS",
"createdAt": "2026-01-02T13:13:31.000Z",
"aiRecordDetail": {
"promptObject": {
"imageUrl": "images/2026_01_07_09_33_18_380_room.png",
"maskUrl": "images/2026_01_07_09_33_43_916_room_mask.png"
},
"resultObject": [
"images/2026_01_07_09_33_51_262_room_erased_object.png"
],
"responseObject": {}
},
"additionalData": null,
"temporaryUrl": "https://s3.us-east-1.amazonaws.com/asset.1min.ai/images/2026_01_02_13_13_31_002_erased_object.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=EXAMPLE_CREDENTIAL&X-Amz-Date=20260102T131331Z&X-Amz-Expires=604800&X-Amz-Signature=example_signature&X-Amz-SignedHeaders=host&x-id=GetObject"
}
}
Use Cases
Photography Cleanup
- Photobomb removal: Remove accidental people or objects from your shots.
- Blemish removal: Erase small imperfections or distractions in the scene.
Real Estate
- Object removal: Remove clutter, temporary signs, or unwanted furniture to showcase the property.
E-commerce
- Product focus: Erase price tags, fingerprints, or supporting structures from product photos.
Notes
- The mask image must have the same dimensions as the source image.
- White pixels in the mask indicate the area to be erased, while black pixels indicate areas to preserve.
- Recraft's AI will attempt to fill the erased region with realistic context from the surrounding image.