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.

{
    "enhancements": ["light", "color", "white_balance", "exposure_correction"]
}

Those types of enhancements can be parametrized further.

    "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.

hdr_light_andvanced

{
    "url": "https://deep-image.ai/api-example3.jpg",
    "enhancements": ["light"],
    "light_parameters": {
        "type": "hdr_light_advanced",
        "level": 1
    }
}

hdr_light

{
    "url": "https://deep-image.ai/api-example3.jpg",
    "enhancements": ["light"],
    "light_parameters": {
        "type": "hdr_light",
        "level": 1
    }
}

contrast

{
    "url": "https://deep-image.ai/api-example3.jpg",
    "enhancements": ["light"],
    "light_parameters": {
        "type": "contrast",
        "level": 1
    }
}

The input image which is little bit desaturated.

The results of color enhancements

hdr_light_andvanced

{
    "url": "https://deep-image.ai/api-example3.jpg",
    "enhancements": ["color"],
    "color_parameters": {
        "type": "hdr_light_advanced",
        "level": 1
    }
}

hdr_light

{
    "url": "https://deep-image.ai/api-example3.jpg",
    "enhancements": ["color"],
    "color_parameters": {
        "type": "hdr_light",
        "level": 1
    }
}

contrast

{
    "url": "https://deep-image.ai/api-example3.jpg",
    "enhancements": ["color"],
    "color_parameters": {
        "type": "contrast",
        "level": 1
    }
}

Combining all together.

hdr_light_andvanced

{
    "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
    }
}

hdr_light

{
    "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
    }
}

contrast

{
    "url": "https://deep-image.ai/api-example3.jpg",
    "enhancements": ["light","color"],
    "light_parameters": {
        "type": "contrast",
        "level": 1
    },
    "color_parameters": {
        "type": "contrast",
        "level": 1
    }
}

White balance correction

White balance can be corrected automatically when the camera settings are incorrect.

{
    "enhancements": ["white_balance"]
}

Exposure correction

Use exposure_correction to correct exposure. Unlike light, it applies gamma correction across the whole image.

    "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.

{
  "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:

{
  "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.

{
  "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.