Name: Image Extender – AI Image Outpainting | Free · $10/mo | API.market
Brand: ailabtools
SKU: api-ailabtools-ai-image-extender
Availability: InStock
Rating: 5.00 (1 reviews)
Author: API Market

# 🤖🖼️AI Image Extender API

The **AI Image Extender API** allows users to seamlessly extend or outpaint images. By either specifying expansion ratios around the edges or providing a mask image, it generates new areas that blend naturally with the original. Users can also guide the extension using text prompts (in English) for creative control.

## Image Example
#### Non-Mask Expanded Image
| Original Image | Expanded Content | Result Image |
|:--------------:|:----------------:|:------------:|
| ![Original Image](https://ai-resource.ailabtools.com/ai-image-extender/doc/OriginalImage-1.webp) | - `top`: 50%<br>- `bottom`: 50%<br>- `left`: 50%<br>- `right`: 50% | ![Result Image](https://ai-resource.ailabtools.com/ai-image-extender/doc/ResultImage-1-05.webp) |

#### Mask Expanded Image
<table style="margin: 0 auto; text-align: center;">
  <thead>
    <tr>
      <th>Original Image</th>
      <th>Mask Image</th>
      <th>Result Image</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td>
        <img loading="lazy" src="https://ai-resource.ailabtools.com/ai-image-extender/doc/mask-OriginalImage-1.webp" alt="Original Image" style="display: block; margin: 0 auto;">
      </td>
      <td>
        <img loading="lazy" src="https://ai-resource.ailabtools.com/ai-image-extender/doc/mask-MaskImage-1.webp" alt="Mask Image" style="display: block; margin: 0 auto;">
      </td>
      <td>
        <img loading="lazy" src="https://ai-resource.ailabtools.com/ai-image-extender/doc/mask-ResultImage-1.webp" alt="Result Image" style="display: block; margin: 0 auto;">
      </td>
    </tr>
  </tbody>
</table>

## Features

1. **Flexible Extension Methods**  
   - **Non-Mask Expansion**: Extend edges by specifying top, bottom, left, and right ratios.  
   - **Mask Expansion**: Provide a separate mask indicating areas to fill or extend.

2. **Custom Prompt Integration**  
   - Supports text prompts to influence the final outpainting creatively.

3. **Adjustable Quality Settings**  
   - Modify sampling steps, strength, and scale for optimal output quality.

4. **High-Resolution Support**  
   - Handles images up to 4096×4096 px and up to 5 MB in size.

## Use Cases

1. **Creative Design & Digital Art**  
   Expand existing images for posters, wallpapers, or new compositions.

2. **Photography & Retouching**  
   Extend backgrounds to create panoramic-like images without manual editing.

3. **Marketing & Advertising**  
   Quickly adapt images to different aspect ratios for various placements.

## API Documentation
### Endpoint


```bash
curl -X 'POST' \
  'https://prod.api.market/api/v1/ailabtools/ai-image-extender/image/editing/ai_image_extender_for_auto' \
  -H 'accept: application/json' \
  -H 'x-magicapi-key: <YOUR API MARKET KEY>' \
  -H 'Content-Type: multipart/form-data' \
  -F 'strength=0.8' \
  -F 'max_height=1920' \
  -F 'left=0.1' \
  -F 'steps=30' \
  -F 'scale=7' \
  -F 'bottom=0.1' \
  -F 'max_width=1920' \
  -F 'seed=0' \
  -F 'custom_prompt=' \
  -F 'top=0.1' \
  -F 'image=@20241011_201008.jpg;type=image/jpeg' \
  -F 'right=0.1'
```

### Request Body

| Field         | Required | Type    | Range         | Default | Description                                                                                                               |
|---------------|----------|---------|---------------|---------|---------------------------------------------------------------------------------------------------------------------------|
| custom_prompt | NO       | string  | --            | --      | Text prompt in English (≤ 100 words). Helps direct how the new area is generated.                                         |
| steps         | NO       | integer | [1, +∞)       | 30      | Sampling steps. Higher values can improve detail but also increase processing time.                                       |
| strength      | NO       | float   | [0.1, 1.0]    | 0.8     | Closeness to the original image. Smaller values preserve more of the original content.                                    |
| scale         | NO       | float   | [1, 20]       | 7       | How strongly `custom_prompt` influences the output. Higher values mean the prompt has more impact.                        |
| seed          | NO       | integer | [≥ -1]        | 0       | Random seed for reproducibility. -1 generates a random seed each time; same positive seed with identical parameters yields consistent results. |
| max_height    | NO       | integer | [≥ 0]         | 1920    | Maximum output height if resizing becomes necessary after expansion.                                                      |
| max_width     | NO       | integer | [≥ 0]         | 1920    | Maximum output width if resizing becomes necessary after expansion.                                                       |

### Response

```bash
{
  "data": {
    "binary_data_base64": [
      "/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAIBAQEBAQIBAQECAgICAgQDAgICAgUEBAMEBgUGBgYFBgYGBwkIBgcJBwYGCAsICQoKCgoKBggLDAsKDAkKCgr/2wBDAQICAgICAgUDAwUKBwYHCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgr/wAARCAeABaADASIAAhEq ..."
    ],
    "request_id": "a6f622ca3cc52d1c84a540ff59283ae17087aafa579bdb59ea9c5a893e61df75"
  },
  "error_code": 0,
  "error_detail": {
    "status_code": 200,
    "code": "",
    "code_message": "",
    "message": ""
  },
  "log_id": "202504042145172D7C953FFAF921186116",
  "request_id": "202504042145172D7C953FFAF921186116",
  "time_elapsed": "4.600317078s"
}
```

## Status Codes & Error Handling

| Field        | Description                                                                                  |
|--------------|----------------------------------------------------------------------------------------------|
| `error_code` | Numeric code indicating success (`0`) or a particular error (e.g., invalid input, file format violation). |
| `error_msg`  | Short text describing the error, if any.                                                     |
| `status_code`| Typically reflects standard HTTP status codes (`200`, `400`, etc.). Use it with `error_code` to check overall status. |

## Additional Details

- **Performance Considerations:**
  - Larger images and higher steps require more computation time.
  - Use `seed` to ensure reproducible results if desired.

- **Best Practices:**
  - Keep `custom_prompt` within 100 English words. Overly lengthy text may be truncated or ignored.
  - Adjust `strength` carefully to balance fidelity with creativity.

## SEO Keywords
AI image extender, Image outpainting, Expand images API, AI image expansion, Image masking, Creative art outpainting, Diffusion-based outpainting, Extend background API

Extends images beyond their borders with AI outpainting. Guide with text prompts. Free 10 calls/mo, from $10/mo. Start free on API.market.

Image Extender – AI Image Outpainting | Free · $10/mo | API.market

BASIC

AILabTools

ULTRA

MEGA

This AI-powered API extends images beyond their borders with smart, seamless content generation. Supports proportional, frame, four-side, and canvas expansions!