Name: Object Replacer – Erase & Generate | Free · $10/mo | API.market
Brand: ailabtools
SKU: api-ailabtools-ai-object-replacer
Availability: InStock
Author: API Market

# 🤖🔄AI Object Replacer API
The **AI Object Replacer API** allows developers to replace specific objects in an image by providing a mask that designates the regions to be modified. Optionally, you can influence the generated output with a custom text prompt. Using advanced diffusion techniques, the API processes the input image and outputs a modified version with the masked areas replaced based on the provided parameters.

## Image Example
<table style="margin: auto;">
  <thead>
    <tr>
      <th style="text-align: center;">Original Image</th>
      <th style="text-align: center;">Prompt Content</th>
      <th style="text-align: center;">Mask Image</th>
      <th style="text-align: center;">Result Image</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td style="text-align: center;">
        <img loading="lazy" src="https://ai-resource.ailabtools.com/ai-object-replacer/doc/OriginalImage-1.webp" alt="Original Image" class="img_ev3q medium-zoom-image">
      </td>
      <td style="text-align: center;">
        <code>A country road winds through a field of dry, yellow grass, bordered by wooden fences on both sides.</code>
      </td>
      <td style="text-align: center;">
        <img loading="lazy" src="https://ai-resource.ailabtools.com/ai-object-replacer/doc/MaskImage-1-1.webp" alt="Mask Image" class="img_ev3q medium-zoom-image">
      </td>
      <td style="text-align: center;">
        <img loading="lazy" src="https://ai-resource.ailabtools.com/ai-object-replacer/doc/ResultImage-1-1.webp" alt="Result Image" class="img_ev3q medium-zoom-image">
      </td>
    </tr>
  </tbody>
</table>

## Features
- **Targeted Object Replacement:** Use a mask to precisely specify the regions in the image to be replaced.
- **Prompt-Driven Customization:** Optionally guide the replacement with a custom prompt (English only, up to 100 words) for tailored outputs.
- **Adjustable Processing Parameters:** Control image quality and processing time via configurable sampling steps, scale, and seed.
- **Broad Image Compatibility:** Supports JPEG, JPG, and PNG formats up to 5 MB, with resolutions from 64×64 px to 4096×4096 px.
- **Compliant Mask Formats:** Accepts single-channel, three-channel, and RGBA mask images (8-bit PNG encoding without ICC profiles).

## Use-Cases
- **Image Editing & Retouching:** Remove unwanted objects and replace them with AI-generated content seamlessly.
- **Content Creation:** Generate new backgrounds or elements in images for creative and commercial projects.
- **Automated Post-Processing:** Integrate into pipelines to enhance photos by replacing objects with consistent, context-aware results.

## API Documentation
### Endpoint
```bash
curl -X 'POST' \
  'https://prod.api.market/api/v1/ailabtools/ai-object-replacer/image/editing/ai-object-replacer' \
  -H 'accept: application/json' \
  -H 'x-magicapi-key: <YOUR API.MARKET KEY>' \
  -H 'Content-Type: multipart/form-data' \
  -F 'custom_prompt=' \
  -F 'steps=25' \
  -F 'scale=5' \
  -F 'seed=-1'
```
### Request fields
| Field         | Required | Type    | Default | Description                                                                                                                                 |
|---------------|----------|---------|---------|---------------------------------------------------------------------------------------------------------------------------------------------|
| image         | YES      | file    | —       | The original image for object replacement. Must adhere to the image requirements.                                                           |
| mask          | YES      | file    | —       | Mask image indicating areas to replace. Must follow the mask image requirements.                                                            |
| custom_prompt | NO       | string  | —       | Optional text prompt (English only, up to 100 words) guiding the replacement. Use standard vocabulary to avoid review issues.               |
| steps         | NO       | integer | 25      | Sampling steps for the diffusion process. Higher values can improve detail but may increase processing time.                                |
| scale         | NO       | float   | 5       | Degree to which the text prompt influences the output. Acceptable values range from 1 to 20.                                                 |
| seed          | NO       | integer | -1      | Random seed for reproducibility. Use -1 for a random seed; a positive integer ensures consistent results when all other parameters remain identical. |
### Response
```bash
{
  "data": {
    "binary_data_base64": [
      "string"
    ]
  },
  "request_id": "string",
  "log_id": "string",
  "error_code": 0,
  "error_detail": {
    "status_code": 0,
    "code": "string",
    "code_message": "string",
    "message": "string"
  },
  "error_msg": "string"
}
```
## Status Codes & Error Handling

| Field        | Description                                                                                   |
|--------------|-----------------------------------------------------------------------------------------------|
| `error_code` | `0` on success; nonzero indicates a specific error (e.g., invalid input or file size).       |
| `error_msg`  | Text describing the error if any.                                                             |
| `status_code`| Mirrors common HTTP status codes (200, 400, etc.). Use alongside `error_code` for complete error diagnosis. |

## Additional Details

- **Diffusion Process**:  
  The algorithm employs diffusion methods to generate high-quality replacements. Adjust the steps and scale for desired detail and prompt influence.

- **Reproducibility**:  
  Utilize the seed parameter to produce consistent results across identical requests.

- **Optimization Tips**:  
  Ensure clear, high-resolution input images and precise masks for optimal performance.

## SEO Keywords
AI object replacer, image object replacement API, diffusion-based image editing, mask-based object replacement, AI image editing, custom prompt image replacement, object removal API, automated image retouching



Remove objects from images and fill the space from a prompt. Free 10 calls/mo, from $10/mo. Try it free on API.market.

Object Replacer – Erase & Generate | Free · $10/mo | API.market

BASIC