Editing

Relight Image

Changed on

Try out this capability in Bria's sandbox

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>
post/relight

Request

  • Base URL: https://engine.prod.bria-api.com/v2/image/edit
  • URL: https://engine.prod.bria-api.com/v2/image/edit/relight
  • Auth: API key in header api_token

Request body

imagestring 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_urlstring uri

Optional URL for receiving the result via webhook when the async job completes. See webhooks.

Response

Successful operation (Synchronous Success)

request_idstring required
warningstring

Returned only when ip_signal = true and the instruction field included IP content.

Changes

  • 1d2fc668005fRevision changes
    • warning

      deleted the header request parameter api_token

    • info

      api tag Editing added

    • info

      api tag v2 endpoints removed