# Bria | Image Expansion

Bria Image Expansion extends photos beyond their borders, generating natural surroundings to fit any aspect ratio. Ideal for ads, ecommerce, and social formats

## API Information

- **Model Slug:** bria-image-expansion
- **Branded URL:** https://www.eachlabs.ai/bria/bria/bria-image-expansion
- **Provider:** Bria
- **Category:** Image to Image
- **Output Type:** image
- **Status:** active
- **Version:** 0.0.1
- **Base Cost:** Bria Image expansion image
- **Estimated Processing Time:** 20 seconds
- **Last Updated:** 2026-07-22
- **Interactive Demo:** https://www.eachlabs.ai/ai-models/bria-image-expansion

## Pricing

- **Charge Type:** dynamic
- **Estimated Price (default example):** $0.0400
- **Pricing Details:** Bria Image expansion image

### Pricing Rules

| Condition | Pricing |
| --- | --- |
| Rule 1 | Bria Image expansion image |

## Input Schema

No input parameters documented.

## Example Request

```bash
curl -X POST https://api.eachlabs.ai/v1/prediction/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "bria-image-expansion",
  "input": {}
}'
```

## Output Schema

Response returned by `GET /v1/prediction/{id}` when the job completes:

```json
{
  "status": "success",
  "predictionID": "string",
  "output": "string (URL of generated image)",
  "metrics": {
    "predict_time": "number (seconds)"
  }
}
```

## Polling

```bash
curl https://api.eachlabs.ai/v1/prediction/{PREDICTION_ID} \
  -H "Authorization: Bearer YOUR_API_KEY"
```

| Status | Meaning |
|--------|---------|
| `processing` | Still running — poll again |
| `success` | Done — read `output` |
| `error` | Failed — read `message` / `details` |

## Webhook (alternative to polling)

Pass `"webhook_url": "https://your.host/path"` in the create request. Eachlabs POSTs this payload when the job ends:

```json
{
  "exec_id": "prediction-uuid",
  "status": "succeeded",
  "output": "https://...",
  "error": ""
}
```

`status` is `"succeeded"` or `"failed"`. `exec_id` equals the `predictionID` from create. Return 2xx within 30 seconds.

## Errors

Error body: `{ "status": "error", "message": "...", "details": "..." }`

| Code | Meaning |
|------|---------|
| `400` | Invalid input |
| `401` | Missing / invalid `Authorization` bearer token |
| `404` | Unknown model or prediction id |
| `429` | Rate limit — 100 creates / min, 10 concurrent per key |
| `5xx` | Retry with backoff |

## Overview

**Bria | Image Expansion Overview**

Bria | Image Expansion is an image-to-image outpainting model that intelligently extends an image beyond its original borders, enabling wider or taller compositions while preserving context, composition, and key visual elements. Delivered by Bria as part of its generative AI image editing suite, this model focuses on seamless aspect ratio adaptation for product, marketing, and creative layouts. Its primary differentiator is commercial-grade, licensed-data training designed for safe use in brand and enterprise workflows. Bria | Image Expansion analyzes the source image, then synthesizes new pixels that blend with the existing scene, making it ideal for reformatting visuals across multiple channels without manual retouching. Integrated through the Bria | Image Expansion API on each::labs, teams can automate repurposing of images for social, web, and display ads while maintaining visual integrity.

## Usage Notes

- API Base URL: `https://api.eachlabs.ai/v1`
- Authentication: send `Authorization: Bearer YOUR_API_KEY`. Generate a key from the Eachlabs dashboard at https://www.eachlabs.ai/dashboard/api-keys.
- File-typed parameters (`*_url`, `image_url`, `video_url`, `audio_url`, etc.) accept publicly-reachable HTTPS URLs only. Upload your asset first (GCS / S3 / your CDN) and pass the resulting URL. Data-URIs and localhost URLs are rejected.
- For structured parameters (arrays / objects) send real JSON values, not stringified payloads.
- Monetary values are reported in USD; per-token / per-megapixel rates may be billed in micro-cents internally.
- Prefer `webhook_url` over polling for long-running predictions — see the Webhook Callback section.