Topaz Image Lighting
Playground
Try it on WavespeedAI!Topaz Image Lighting adjusts and balances images to improve quality despite sub-optimal lighting. Fix exposure, white balance, and color temperature. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Features
Topaz Image Lighting
Topaz Image Lighting is a professional-grade image lighting and color adjustment model powered by Topaz Labs’ AI technology. Upload your image and let AI automatically adjust lighting, correct white balance, or even colorize black-and-white photos.
Why Choose This?
-
AI-powered lighting adjustment Automatically enhance exposure, shadows, highlights, and overall lighting balance.
-
White balance correction Fix color casts and correct inaccurate white balance from any lighting condition.
-
Photo colorization Transform black-and-white photos into natural-looking color images.
-
Professional quality Powered by Topaz Labs’ AI, trusted by professional photographers worldwide.
-
Multiple output formats Export as JPEG, PNG, or TIFF based on your workflow needs.
Parameters
| Parameter | Required | Description |
|---|---|---|
| image | Yes | Source image to process (upload or URL) |
| model | No | Processing model to use (default: Adjust) |
| output_format | No | Output format: jpeg, jpg, png, tiff, or tif |
Model Options
| Model | Description |
|---|---|
| Adjust | General lighting and exposure adjustment (default) |
| Adjust V2 | Improved lighting adjustment with better tonal range |
| White Balance | Correct color casts and white balance issues |
| Colorize | Add natural color to black-and-white images |
Output Format Options
- jpeg / jpg — Compressed format, smaller file size
- png — Lossless format, supports transparency
- tiff / tif — Professional format, highest quality preservation
How to Use
- Upload your image — drag and drop or paste a URL.
- Select model — choose based on what you want to achieve.
- Choose output format — select based on your quality and file size needs.
- Run — submit and download the processed image.
Pricing
| Item | Cost |
|---|---|
| Per image | $0.07 |
Simple flat-rate pricing regardless of image size or model selected.
Best Use Cases
- Exposure Correction — Fix underexposed or overexposed photos.
- White Balance Fix — Correct color casts from artificial lighting.
- Photo Restoration — Colorize old black-and-white family photos.
- Batch Processing — Consistently adjust lighting across multiple images.
- Professional Editing — Quick lighting fixes in professional workflows.
Pro Tips
- Use Adjust V2 for better results on challenging lighting conditions.
- White Balance model works best on images with obvious color casts.
- Colorize model produces natural results but may need manual tweaking for historical accuracy.
- For archival work, export as TIFF to preserve maximum quality.
Notes
- Adjust models work on both color and black-and-white images.
- Colorize model is specifically designed for black-and-white to color conversion.
- Results may vary based on original image quality and lighting conditions.
Related Models
- Topaz Image Sharpen — AI-powered image sharpening.
- Topaz Image Enhance — AI-powered image upscaling.
- Topaz Image Denoise — AI-powered noise reduction.
- Topaz Image Restore — AI-powered dust and scratch removal.
Authentication
For authentication details, please refer to the Authentication Guide.
API Endpoints
Submit Task & Query Result
# Submit the task
curl --location --request POST "https://api.wavespeed.ai/api/v3/topaz/image/lighting" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}" \
--data-raw '{
"model": "Adjust",
"output_format": "jpeg",
"enable_base64_output": false
}'
# Get the result
curl --location --request GET "https://api.wavespeed.ai/api/v3/predictions/${requestId}/result" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}"
Parameters
Task Submission Parameters
Request Parameters
| Parameter | Type | Required | Default | Range | Description |
|---|---|---|---|---|---|
| image | string | No | - | The image file to be processed. Supported formats (png jpg jpeg tiff tif) | |
| model | string | No | Adjust | Adjust, Adjust V2, White Balance, Colorize | The lighting model to use. Adjust: Balance exposure and lighting. Adjust V2: Enhanced lighting adjustment. White Balance: Correct color temperature. Colorize: Add natural color to images. |
| output_format | string | No | jpeg | jpeg, jpg, png, tiff, tif | The format of the output image. |
| enable_base64_output | boolean | No | false | - | If enabled, the output will be encoded into a BASE64 string instead of a URL. This property is only available through the API. |
Response Parameters
| Parameter | Type | Description |
|---|---|---|
| code | integer | HTTP status code (e.g., 200 for success) |
| message | string | Status message (e.g., “success”) |
| data.id | string | Unique identifier for the prediction, Task Id |
| data.model | string | Model ID used for the prediction |
| data.outputs | array | Array of URLs to the generated content (empty when status is not completed) |
| data.urls | object | Object containing related API endpoints |
| data.urls.get | string | URL to retrieve the prediction result |
| data.has_nsfw_contents | array | Array of boolean values indicating NSFW detection for each output |
| data.status | string | Status of the task: created, processing, completed, or failed |
| data.created_at | string | ISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”) |
| data.error | string | Error message (empty if no error occurred) |
| data.timings | object | Object containing timing details |
| data.timings.inference | integer | Inference time in milliseconds |
Result Request Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| id | string | Yes | - | Task ID |
Result Response Parameters
| Parameter | Type | Description |
|---|---|---|
| code | integer | HTTP status code (e.g., 200 for success) |
| message | string | Status message (e.g., “success”) |
| data | object | The prediction data object containing all details |
| data.id | string | Unique identifier for the prediction, the ID of the prediction to get |
| data.model | string | Model ID used for the prediction |
| data.outputs | string | Array of URLs to the generated content (empty when status is not completed). |
| data.urls | object | Object containing related API endpoints |
| data.urls.get | string | URL to retrieve the prediction result |
| data.status | string | Status of the task: created, processing, completed, or failed |
| data.created_at | string | ISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”) |
| data.error | string | Error message (empty if no error occurred) |
| data.timings | object | Object containing timing details |
| data.timings.inference | integer | Inference time in milliseconds |