> For the complete documentation index, see [llms.txt](https://documentation.deep-image.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.deep-image.ai/image-processing/enhance-lighting-and-colors/enhance-lighting-and-colors.md). # Classic ### Classic Classic provides the existing light, color, white-balance, and exposure-correction algorithms. Image lighting, colors, and contrast can be enhanced with `light`, `color`, and `white_balance`. ```json { "enhancements": ["light", "color", "white_balance", "exposure_correction"] } ``` Those types of enhancements can be parametrized further. ```json "light_parameters": { "type": "contrast", // "hdr_light" | "hdr_light_advanced" "level": 0.8 }, "color_parameters": { "type": "contrast", // "hdr_light" | "hdr_light_advanced", "level": 0.8 }, "white_balance_parameters": { "level": 0.8 } ``` #### Types of light and color algorithms Let's check the various combinations of light algorithms enhancements. Our input image:

The results of 3 light enhancement types. {% tabs %} {% tab title="hdr\_light\_andvanced" %} ```json { "url": "https://deep-image.ai/api-example3.jpg", "enhancements": ["light"], "light_parameters": { "type": "hdr_light_advanced", "level": 1 } } ```

{% endtab %} {% tab title="hdr\_light" %} ```json { "url": "https://deep-image.ai/api-example3.jpg", "enhancements": ["light"], "light_parameters": { "type": "hdr_light", "level": 1 } } ```

{% endtab %} {% tab title="contrast" %} ```json { "url": "https://deep-image.ai/api-example3.jpg", "enhancements": ["light"], "light_parameters": { "type": "contrast", "level": 1 } } ```

{% endtab %} {% endtabs %} The input image which is little bit desaturated.

The results of color enhancements {% tabs %} {% tab title="hdr\_light\_andvanced" %} ```json { "url": "https://deep-image.ai/api-example3.jpg", "enhancements": ["color"], "color_parameters": { "type": "hdr_light_advanced", "level": 1 } } ```

{% endtab %} {% tab title="hdr\_light" %} ```json { "url": "https://deep-image.ai/api-example3.jpg", "enhancements": ["color"], "color_parameters": { "type": "hdr_light", "level": 1 } } ```

{% endtab %} {% tab title="contrast" %} ```json { "url": "https://deep-image.ai/api-example3.jpg", "enhancements": ["color"], "color_parameters": { "type": "contrast", "level": 1 } } ```

{% endtab %} {% endtabs %} Combining all together. {% tabs %} {% tab title="hdr\_light\_andvanced" %} ```json { "url": "https://deep-image.ai/api-example3.jpg", "enhancements": ["light","color"], "light_parameters": { "type": "hdr_light_advanced", "level": 1 }, "color_parameters": { "type": "hdr_light_advanced", "level": 1 } } ```

{% endtab %} {% tab title="hdr\_light" %} ```json { "url": "https://deep-image.ai/api-example3.jpg", "enhancements": ["light","color"], "light_parameters": { "type": "hdr_light", "level": 1 }, "color_parameters": { "type": "hdr_light", "level": 1 } } ```

{% endtab %} {% tab title="contrast" %} ```json { "url": "https://deep-image.ai/api-example3.jpg", "enhancements": ["light","color"], "light_parameters": { "type": "contrast", "level": 1 }, "color_parameters": { "type": "contrast", "level": 1 } } ```

{% endtab %} {% endtabs %} #### White balance correction White balance can be corrected automatically when the camera settings are incorrect.

```json { "enhancements": ["white_balance"] } ```

#### Exposure correction Use `exposure_correction` to correct exposure. Unlike `light`, it applies gamma correction across the whole image. ```json "enhancements": ["exposure_correction"] ```

https://deep-image.ai/api-example3.jpg exposure corrected

### Advanced Advanced uses Flux Relight to generate improved lighting and colors. It transfers those changes back to the original image. The output always retains the original image resolution. #### Enable Advanced correction Add `generative_tone_correction` to `enhancements`. Pass custom settings in `generative_tone_correction_parameters`. ```json { "url": "image_url", "enhancements": ["generative_tone_correction"], "generative_tone_correction_parameters": { "exposure_strength": 0.8, "contrast_strength": 0.8, "white_balance_strength": 0.9, "saturation_strength": 0.8, "light_transfer_strength": 0.4, "generated_image_strength": 0.0, "local_light_strength": 0.0, "lora_scale": 1.0, "seed": 42, "classic_transfer": true, "preserve_source_chroma": false } } ``` The web labels are not JSON field names. #### Choose what to correct The controls are independent and cumulative. Set a component to `0.0` to disable its transfer. * **Light only:** use `light_transfer_strength`, `exposure_strength`, and `contrast_strength`. Set `white_balance_strength` and `saturation_strength` to `0.0`. * **Colors only:** use `white_balance_strength` and `saturation_strength`. Set `light_transfer_strength`, `exposure_strength`, and `contrast_strength` to `0.0`. * **Light and colors:** configure all five strengths as needed. Every strength accepts a floating-point value from `0.0` to `1.0`. A value of `1.0` requests the strongest transfer. Scene-dependent safety limits may reduce it. Setting a component to `0.0` does not disable the processing pipeline. #### Parameters When `generative_tone_correction_parameters` is omitted, Advanced uses these defaults: ```json { "exposure_strength": 0.8, "contrast_strength": 0.8, "white_balance_strength": 0.9, "saturation_strength": 0.8, "light_transfer_strength": 0.4, "generated_image_strength": 0.0, "local_light_strength": 0.0, "lora_scale": 1.0, "seed": 42, "classic_transfer": true, "preserve_source_chroma": false } ``` * **Light transfer** → `light_transfer_strength` — default `0.4`. Transfers broad illumination and the global tone curve. It avoids copying texture or geometry. Values from `0.2` to `0.4` are usually safer. * **Exposure** → `exposure_strength` — default `0.8`. Controls transfer of overall brightness. It is not an exposure value in stops. * **Contrast** → `contrast_strength` — default `0.8`. Moves the image toward the reference tonal range. With light transfer, it uses an edge-aware tone field. * **White balance** → `white_balance_strength` — default `0.9`. Controls estimated color temperature and tint correction. It does not set Kelvin or a fixed tint. * **Saturation** → `saturation_strength` — default `0.8`. Controls color-intensity transfer. A value of `0.0` does not convert the image to grayscale. The web app percentage maps directly to the API strength: ``` API strength = web percentage / 100 ``` For example, **White balance** at `70%` uses `white_balance_strength: 0.7`. Lowering `light_transfer_strength` does not disable the other corrections. They are still evaluated when their strengths are greater than `0.0`. #### Auto Enhance preset The normal **Auto Enhance** web option uses `auto_enhance_tone_correction`. ```json { "url": "image_url", "preset": "auto_enhance_tone_correction" } ``` This preset combines denoise, face enhancement, and Natural Balance Advanced correction. It does not run legacy exposure, light, color, white-balance, or deblur models. The legacy `auto_enhance` preset remains available for API compatibility.