---
title: "Relight Image"
method: POST
path: "/relight"
tags: ["v2 endpoints"]
---

# Relight Image

`POST /relight`

[**Try out this capability in Bria's sandbox**](https://platform.bria.ai/image-editing/relight-image)

**Description**

Modify the lighting setup (direction and atmosphere) of an image.

**Example:**

* Light Type: "spotlight on subject, keep background settings"

<table>
  <tr>
    <th style="text-align: center;">Input Image</th>
    <th style="text-align: center;">Output Image</th>
  </tr>
  <tr>
    <td align="center" style="vertical-align: middle;">
      <img src="https://bria-datasets.s3.us-east-1.amazonaws.com/Liza/bria_result+-+2026-01-13T095546.173.png" width="300" style="border-radius: 8px;">
    </td>
    <td align="center" style="vertical-align: middle;">
      <img src="https://bria-datasets.s3.us-east-1.amazonaws.com/Liza/bria_result+-+2026-01-13T100345.725+(1).png" width="300" style="border-radius: 8px;">
    </td>
  </tr>
</table>

## Headers

- `api_token` string, required

## Request body

- object
  - `image` string, required — The source image to be handled by the API. Supported input types: - **Base64-encoded string** - **URL** pointing to an image file that is publicly accessible and available at the time of processing. Accepted formats: **JPEG**, **JPG**, **PNG**, **WEBP**.
  - `light_direction` 'front' | 'side' | 'bottom' | 'top-down' — Direction (e.g., "front", "side", "top-down").
  - `light_type` 'midday' | 'blue hour light' | 'low-angle sunlight' | 'sunrise light' | 'spotlight on subject, keep background settings' | 'overcast light' | 'soft overcast daylight lighting' | 'cloud-filtered lighting' | 'fog-diffused lighting' | 'moonlight lighting' | 'starlight lighting nighttime' | 'soft bokeh lighting' | 'harsh studio lighting keep background setting', required — Type (e.g., "sunset", "studio", "neon").
  - `webhook_url` string, uri — Optional URL for receiving the result via webhook when the async job completes. See [Webhooks](https://docs.bria.ai/webhooks).

## Response `200`

Successful operation (Synchronous Success)

- SyncEditResponse
  - `result` object, required
    - `image_url` string, required
    - `seed` integer, required
    - `structured_instruction` string, required
  - `request_id` string, required
  - `warning` string — Returned only when ip_signal = true and the instruction field included IP content.

## Other responses

- `202` — Accepted (Asynchronous). You can track the progress and retrieve the final result using the Status Service. For more details, refer to the [Status Service](https://docs.bria.ai/status) section.
- `400` — Bad request.
- `401` — Unauthorized.
- `403` — Forbidden.
- `404` — Not found.
- `415` — Unsupported media type.
- `422` — Unprocessable Entity.
- `429` — Request limit exceeded.
- `5XX` — Internal Server Error.

---

[API](https://skmtc.net/bria-ai/apis/image-editing-api-reference.md) · [All operations](https://skmtc.net/bria-ai/apis/image-editing-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bria-ai/image-editing-api-reference/versions/53e73f49bf9f/schema)